keel-autopilot
Skill9 starsChanged 51 days agoMITView on GitHub
Gated autonomy for one session — advance phases back-to-back with the full /keel-phase-review run at every gate, auto-commit at phase ends, batch pushes for ONE approval. Stops on gate FAIL, UNCERTAIN decisions, architecture surprises, or security-adjacent changes. Push is never automatic. Solo sessions or an agent team's orchestrator ONLY — never a worker/co-agent (it runs phase-review and commits, both forbidden to them by rules §10.42).
In this repository17 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- keel-adoptSkill
- keel-agent-team-createSkill
- keel-agent-team-startSkill
- keel-auditSkill
- keel-compactSkill
- keel-continueSkill
- keel-distillSkill
- keel-handoverSkill
- keel-phase-reviewSkill
- keel-pilotSkill
- keel-planSkill
- keel-researchSkill
- keel-statsSkill
- keel-teamSkill
- keel-tidySkill
- keel-updateSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
When: the user explicitly turns it on ("/keel-autopilot", "autopilot", "work through the phases on your own").
- Very specific: line 26
Gates stay evidence-based: When ## Now empties, run the FULL /keel-phase-review checklist yourself.
- Distinctive: line 30
Commit locally, batch the push: Commit at each phase end (owner identity, §6.16).
- Very specific: line 50
Never bypassed: push approval, /keel-pilot human routing, hook blocks, §0 bootstrap approvals, /keel-distill's never-lossy-delete.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
/keel-autopilot — phases advance themselves; evidence gates don't move
When: the user explicitly turns it on ("/keel-autopilot", "autopilot", "work through the phases on your own"). Autonomy is the USER's grant, never self-granted — and it changes WHO presses the button, not WHAT the gates require.
Who may run it: a SOLO session, or an agent team's ORCHESTRATOR — never a worker/co-agent. This
mode runs /keel-phase-review (rule 2) and commits (rule 3), and §10.42 forbids a worker BOTH. So
check identity before the first step: the reground hook prints this session's agent from
.claude/agent-team-sessions; if it names a worker charter, say so and stop. Do NOT infer the answer
from git config user.name — same-machine agent sessions all share ONE git identity, which is exactly
why rule 4's ownership check cannot see this by itself.
Mode contract (4 rules):
- In-phase autonomy. Work the wip phase's
TASKS ## Nowitems back-to-back without pausing for confirmation; make routine judgment calls yourself (§10.36). Memory discipline stays hot-path: LESSONS the moment something is learned, TASKS updated as you go — autopilot without the rituals is just drift at higher speed. On a multi-user project, an@-assigned item still STARTS with the §10.41 spec briefing before the work (task-specific, self-explanatory questions; check the spec's Comprehension log first — an already-answered question is never re-asked). - Gates stay evidence-based. When
## Nowempties, run the FULL/keel-phase-reviewchecklist yourself. PASS needs real evidence (tests green viamake test, the gate's done-when observed) — never narrate a pass. PASS → flip the phase, seed the next## Nowfrom PLAN.md, continue. FAIL → stop and report what's missing. - Commit locally, batch the push. Commit at each phase end (owner identity, §6.16); do NOT push.
Accumulate the queue and present it at session end (or on request) for ONE approval.
settings.json'saskon push is the enforced backstop — never weaken it for this mode. - Stop-and-ask triggers. Halt and return to the user when: a gate FAILS · a decision is
UNCERTAIN (verifier verdict or §10.37 grounding gap) · a scope/architecture surprise would need a
new ADR · anything security-adjacent (secrets, auth, non-routine dependency changes) · a bulk
output hits the
/keel-pilotthreshold (its human-routing rules override autopilot) · the same test is red twice after fixes · the next## Nowitem or wip phase belongs to someone else — autopilot NEVER does another's assigned work; stop and surface it (the parallel-work collision the ownership tag exists to prevent). Match ownership on the RIGHT key: on a human multi-user project that is@owner≠git config user.name; on a same-machine agent team every session shares one git identity, so compare the item's lane/@tagagainst this session's agent name from.claude/agent-team-sessionsinstead — the git check alone is inert there and silently passes.
Boundaries:
- One session. Cross-session automation (cron, /loop) is out of scope — re-request the mode each
session, or make it a standing project agreement via a
LESSONS.md [rule]line. - After any compaction, re-confirm. The activation may live only in summarized-away conversation; ask one line ("autopilot still on?") before continuing autonomously. Note the activation in the next HANDOVER block (d) so the grant survives on disk.
- Never bypassed: push approval,
/keel-pilothuman routing, hook blocks, §0 bootstrap approvals,/keel-distill's never-lossy-delete. The Stop hooks (plan-phase-nudge, handover reminder) keep firing — they are the net under the tightrope, not an annoyance to suppress.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

