Pilot's store environment: the brain's scripts and skills, and no data — Pilot's record lives in
its database. The app is pvginkel/PilotApp.
CLAUDE.md: the brain's map, what holds in every session Pilot runs here — who it is, where its project's files are, its tools andpilot.py's verbs, the invariants, and how it writes..claude/skills/<name>/SKILL.md: the four skills a brief opens with,create,chat,pre-ruleandplan, each with its frontmatter, its first step, the rule files it applies, and the brief's slot,## The brief, last. Between them,chat's body is the project's chat's procedure on Pilot'spilot-storetools and the brief the server composes, a ruling it records on an item of Pilot's own carried out in its own turn, with no job after it, an action of one the person hands to a worker claimed for that work item, an ask of Pilot's own called off throughcancel_askfor the person who says it is obsolete, a work item a correction replaces closed throughstop_workwith its reason, and one the person drops with their words as it, both byrules/work-items.md, and a conversation with a session outside Pilot under a frame of its own, the session's words a request and never a ruling, what needs the operator an item, the work it starts placed by repository and never in the session's environment byrules/placement.md,create's the definition chat's, which writes the draft with the person,pre-rule's the pass over what a worker's turn registered, each open block routed byrules/routing.md, its writer asked, an action claimed or a fact researched for it where the routes say so, an action of the granted column with auto pilot off, a held push above all, confirmed first and claimed on the operator's Yes, a close-out's promotion deferred to the run's own task, a researched block routed on what its work found, the stage session's debrief, where the brief carries one, left or made a notice, a card, a comment on an open card on the same change, or a fieldnote, and the pass after the writer answered, which asks nothing, andplan's the plan's upkeep in its modes, in the order a job meets them: the setup, the first job at Create project; an action of Pilot's done, thedoneof a claimed action after a turn of its run, of a worker's document or of an item of Pilot's own, which thatdonecloses on its last open block, one Pilot's server hands back left to the operator, and of each action deferred with a close-out's promotion after its work's turn, its notes standing until then; an item of Pilot's own a person closed in the app; what is next after the pass, after that close and in the chat, every task that can start started, a close-out's deferred promotion once the run's continuation has ended, read on every task of the plan and started once the handbook lets it go, a criterion owed after an act of Pilot's own in the store settled by the job that does the act, a cancelled run's a notice to the operator and nothing started, the handbook's result checked at the plan's end, the operator asked for the next step where the handbook grows the plan in the chat; a wait's firings, each judged on the card read again, the wait closed throughmarkwith its note once its event came, the note on its task struck and the task started by the plan's one passage on starting a task, or left open, with its backstop, a card wait and its backstop closed together; the sweep; and the finish decision, whose Finish and archive callsfinishwitharchive.rules/: the rules the skills apply, each file the one home of its own —grants.md(what goes ahead and what asks the operator first, an operator action Pilot can run itself and the topic-branch push and the deploy a worker follows among it),routing.md(where an open block goes: the claim, of a worker's document or of an item of Pilot's own, how long a run holds a block, a resume that waits on work, due diligence, deferral, a wait and a close-out's promotion among it),work-items.md(a work item's fields and its brief, the close of its own card and its close for good, replaced or dropped),placement.md(a work item's repository, work born of a conversation placed by it, a design, model and effort),stages.md(the workflow's stages from Pilot, a slice or a work item and taking a slice among them) andpromote.md(a promotion's procedure, which its brief carries). What every session shares — the server's follow-up turn, the effect lines, the facts read elsewhere — isCLAUDE.md's, and the skills point at it..kubecoder/config.yaml: the environment, with thepilot-syncservice, which keeps/work/Projectsin step with the record, and the catalog'spythontoolchain..claude/settings.jsonand.claude/hooks/pilot-sync-lock.py: the hook that takes the project's write lock inpilot-syncbefore eachEdit,Write,MultiEditandBashcall of a session Pilot's server created, so that what the call saves is credited to the session, and gives it back after the call withpilot-sync's report of what the record holds against the project; at the turn's end it gives back every hold the session has left.tools/pilot.py: the brain's editing scripts over one project's folder; it calls neitherpilot-syncnor Pilot, the hook's check after itsBashcall reporting its writes.pilot.py --helpprints every verb's usage.pyproject.tomlanduv.lock: a uv project, whose one dependency ispilot-dsl, PilotApp's block DSL (backend/packages/pilot-dsl), taken from GitHub at the commituv.lockpins. A change to the grammar in PilotApp moves the pin by hand: the commit inpyproject.toml, thencexec python uv lock.
Each of Pilot's stages has a store environment of its own that checks this repo out, and its
sidecar syncs with that stage's Pilot: https://pilot-dev.home for the dev stage,
https://pilot.ginbov.nl for production. The catalog's pilot-sync entry names which. A store
takes this repo's main when it is stopped and reset, which clones it again; a restart does not
pull it.
The dev image has no uv, so everything runs in the python tool container, from the repo's root:
kc project setup:uv sync --locked, which pod start runs too.cexec python uv run tools/pilot.py <verb> …: the script, on the folder$PILOT_PROJECTnames, or--project <folder>.kc project test: every test undertests/:pilot.py's, against invented project folders (tests/fixtures/tree/); the hook's, against a stand-in forpilot-sync's local endpoint; and the map's (tests/test_map.py), which holdsCLAUDE.md, the rule files and the skills to their shape: the skills named as their folders with the brief last, the format skill cited by its name, the paths they cite there,CLAUDE.md's verb lines equal topilot.py's own and its tools those the hook locks around, everypilot.pycommand line they quote a verb and options its parser takes, the grants naming the confirmation reasons of the fixtures'reference.jsonand the topic branch and the deploy a worker follows in both switch texts and in a brief's fetch, a resume that waits on work holding its blocks through that work, the brief lines and theask_writerandadd_itemcalls the pre-rule and plan skills quote as the server writes and takes them, what the pass may make of the stage session's debrief, a card on it one of the two exceptionsrules/stages.mdmakes to a stage's documents, theLatercard the other, an action of an item of Pilot's own that a work item does claimed byrules/routing.md's one section, whichCLAUDE.mdand the chat and plan skills cite, itsdonethe item's close,cancel_askby its arguments inCLAUDE.mdand the chat skill and nowhere else,stop_work'sreasoninCLAUDE.md, a work item's fields, its brief and its close for good inrules/work-items.mdalone, which the chat and plan skills cite, and each rule a consolidation gave one home held there, the places that restated it pointing at it, and a conversation with a session outside Pilot: its kind line mapped to the chat skill, the skill's frame for it,chat.md's conversations read as a calling session's requests inCLAUDE.mdand the chat skill, and the work it starts placed by repository, never in its environment, byrules/placement.md, which the work item's field line and a stage's brief follow.