Skill · v1.0

Autonomous Improvement Session

Autonomous Improvement Session is the skill you run when you have capacity to spare and want your system improving without watching it. You invoke it, it works, it shows you what it did and surfaces only the decisions that genuinely need you. The flywheel grows with every cycle.

Install

Claude Code (CLI / WSL / Git Bash)

/plugin marketplace add https://www.infinitegameos.io/marketplace.json
/plugin install autonomous-improvement-session@igos-library

Claude Code (VS Code)

Install in VS Code

Opens the Claude Code plugins dialog with the marketplace and skill prefilled. Requires the Claude Code VS Code extension installed and signed in. Or paste the snippet below into .claude/settings.json for VS Code, JetBrains or any setup that prefers manual config.

{
  "extraKnownMarketplaces": {
    "igos-library": {
      "source": {
        "source": "url",
        "url": "https://www.infinitegameos.io/marketplace.json"
      }
    }
  },
  "enabledPlugins": {
    "autonomous-improvement-session@igos-library": true
  }
}

Direct markdown URL (Claude Code, Cursor, Codex CLI)

https://www.infinitegameos.io/markdown/skills/autonomous-improvement-session

This URL returns the narrative concept page. The plugin install path above delivers the operational SKILL.md instruction file.

Cursor (.mdc rules file)

curl -O https://www.infinitegameos.io/install/cursor/autonomous-improvement-session.mdc

Aider, Cline, any agent with --read

curl -O https://www.infinitegameos.io/markdown/skills/autonomous-improvement-session
aider --read autonomous-improvement-session.md

This skill ships in both homes, the Sovereign Ecosystem Foundation and this library.

Definition

Autonomous Improvement Session is an operator-invoked hygiene and improvement engine. When you have extra capacity, you fire it and it runs a menu of safe, additive, system-internal work: broken references repaired in place, index entries added for active files, anti-AI sweeps applied to draft articles, slug normalization across memory files. Tier 1 items land edits directly. Tier 2 items are read-only scans that write findings to a decision board for your review. A threshold model governs execution authority: every action carries an autonomy level, and the threshold starts at the lowest level so every starter item runs without asking. The threshold climbs only through ratified decisions you make after reviewing a run. Menu growth is fast and wide; execution authority is slow and earned. The decision board is the single review surface: four buckets (completed this run for review, approvals and questions, new menu candidates, proposed plans) regenerated fresh each run. No report files land in your inbox. The run log entry and version control commit are the durable trail. It also ships inside the Sovereign Ecosystem Foundation, the starting workspace where these disciplines live together.

Two speeds on purpose

The skill runs at two speeds simultaneously. Menu growth is fast and wide: a research rotation casts a wide net for categories and mechanisms of improvement, and the menu of things the skill knows how to do grows every cycle. Execution authority is slow and earned: the threshold starts at the lowest level and climbs only through ratified decisions you make after reviewing the board. A wide net for ideas. A narrow gate for action. The gate widens with proof, never with time.

Tier 1 items execute and log. Tier 2 items scan and report. The default verb is DO, not propose. If an action is additive, reversible, system-internal and touches no deletion, no canonical governance file and no outward surface, the skill does it and records it. Safe work is act-then-show. The Permanent Floor is the hard ceiling that holds regardless of how high the threshold climbs: no deletions, no voice or copy changes on live surfaces, no outward broadcasts, no direct push to main, no self-modification.

The decision board and the return session

Every run closes with a four-bucket decision board regenerated fresh, replacing the prior run's open decisions. Bucket one is a skim record: what ran, each item reversible. Bucket two is approvals and questions: genuine judgment forks the skill surfaced rather than acted on. Bucket three is new menu candidates from the research rotation. Bucket four is proposed plans for anything bigger than one session. A clean run leaves bucket two near empty, because safe work is already done.

The return session is how the flywheel learns. You answer decisions, encode forward rules, accept or decline menu candidates and ratify any autonomy-level moves. An accepted candidate adds a new menu item. A ratified climb raises the threshold by one proven step. The skill never edits its own menu or threshold autonomously. Every move is explicit and operator-triggered.

Use Cases

End-of-session hygiene when capacity remains

A build session wraps with tokens and time to spare. You invoke Autonomous Improvement. The skill checks eligibility across the starter menu, runs five reference-integrity repairs and two index additions, surfaces two ambiguous routing decisions and one menu candidate from the research rotation. You close the session knowing the system is cleaner than when you started and the decision board is waiting when you're ready.

Heading out with a messy system

You're leaving for a few hours and your system has accumulated drift: references that moved, index entries not added, draft articles with known anti-AI patterns. You fire Autonomous Improvement with a full-sweep hint. The skill works the Tier 1 menu completely, runs two Tier 2 research scans and writes the board. You come back to a cleaner system and a decision board to skim, not a to-do list to build from scratch.

Growing the menu through the research rotation

After five runs the starter menu starts feeling thin relative to what the system actually accumulates. The research rotation surfaces a new candidate: broken wikilink detection across a notes directory. You review it in bucket three, accept it and encode the execution spec in the return session. The next run includes the new item. The skill's reach grew through proven operation, not by assumption.

FAQ

Why operator-invoked only and never scheduled?

Scheduling is a future direction gated on a track record of clean review-and-climb cycles, not a date. Autonomous improvement on a cron job with an unproven threshold is a liability. Operator invocation keeps you in the loop until the threshold has earned the right to run without you watching. The machinery for scheduling already exists in the threshold model; the cadence comes after the proof.

What is the Permanent Floor and why does it never move?

The floor is the hard ceiling on what the skill does regardless of how high the autonomy threshold climbs: no deletions, no voice or copy changes on live surfaces, no outward broadcasts, no direct push to main, no self-modification. The floor is drawn by action type, not location. A ratified climb, an accepted candidate and a forward rule can never breach it. The safety guard is in the floor, not in the threshold mechanics.

How is this different from just asking my AI to clean things up?

An ad-hoc cleanup request has no memory, no eligibility tracking, no threshold model and no decision board. It does the work once and forgets it happened. Autonomous Improvement Session carries state across runs in the log frontmatter, tracks what ran and when, grows a menu with each cycle and escalates execution authority only through ratified decisions. The difference is a flywheel versus a one-shot.

Autonomous Improvement Session pairs naturally with Session Closeout: run improvement when you have capacity to spare, then run closeout to seal the session. Pattern Harvest works the same flywheel from the reflective side. All three ship inside the Sovereign Ecosystem Foundation. The Sovereign Life Playbook is the upstream design frame for systems worth improving.

See the Sovereign Life Playbook