Repository navigation
Autonomous Execution
| Skill | Trigger | Purpose |
|---|---|---|
wtf.loop |
"go", "start building", "build it all" | Chain implement → verify → PR → re-aim for every Trace, Skeleton first |
wtf.loop needs a fully specified tree of an Epic, its Features, and their Traces. It runs each Trace the same way as the manual skills, but without the "what's next?" prompts.
- Graph — the loop reads the Epic, its Features, and their Traces. It builds the dependency graph.
- Check — the loop runs the pre-flight checks: spec completeness, contradictions, codebase mismatches, and circular dependencies.
- Review — the loop proposes an execution plan. You approve it.
- Execute — the loop runs the Traces of each Feature. Features that share no files run in parallel.
-
Deliver — each Feature ends as one linear stack of Trace PRs. In
stageddelivery, the loop then opens the feature PR tomain. Intrunkdelivery, the last Trace PR closes the Feature.
flowchart LR
%%{init: {"flowchart": {"wrappingWidth": 260}}}%%
t10("#10 Skeleton<br/>first, alone"):::yellow
t11("#11 Extension<br/>no shared files"):::lime
t12("#12 Deepening<br/>no shared files"):::azure
t13("#13 Deepening<br/>shares files: waits"):::cyan
t10 --> t11 & t12
t11 & t12 --> t13
linkStyle default stroke-width:3px
classDef yellow fill:#DEDE00,stroke:#DEDE00,color:#000
classDef lime fill:#9DEC00,stroke:#9DEC00,color:#000
classDef azure fill:#0076EC,stroke:#0076EC,color:#fff
classDef cyan fill:#00ECEC,stroke:#00ECEC,color:#000
The Skeleton runs first and alone. When its PR is open and green, the file-conflict graph puts the other Traces into sub-phases:
- Traces that share no files build at the same time, each in its own worktree.
- A Trace that shares files with an earlier Trace waits for the next sub-phase.
- A Trace never waits for a merge. It starts its branch from the top of the stack.
-
Implement —
wtf.implement-tracedrives TDD over the Scenario Claim. -
Verify —
wtf.verify-traceruns the claimed scenarios. - Join the stack — when necessary, the loop rebases the branch onto the top of the stack. Then it runs the tests and pushes the branch.
- Open the PR — the PR targets the top of the stack. The loop links it into the native GitHub stack.
- Merge — the loop waits for CI. If the repo has no required reviews, the loop merges bottom-up when CI is green. If the repo has required reviews, the PR waits for a reviewer, and the loop continues.
-
Re-aim —
wtf.refineruns without prompts and updates the Trace Plan of the Feature.
Traces join the stack of their Feature in a fixed order: sub-phase first, then Trace Plan order. In the example, #11 and #12 build at the same time. #11 joins first. Then #12 rebases onto #11 and joins on top of it. At the end of the run, the Feature is one linear stack:
gitGraph
commit id: "main"
branch trace/10
commit id: "#10 Skeleton"
branch trace/11
commit id: "#11 Extension"
branch trace/12
commit id: "#12 Deepening"
branch trace/13
commit id: "#13 Deepening"
Each PR targets the branch below it. The bottom PR targets the feature branch in staged delivery, or main in trunk. Delivery and stacks shows how the stack merges into main.
The loop stops only for a human decision: a contradiction, an ambiguity, or a change to the set of scenarios in a Trace Plan. It collects the open questions and asks them all at one time.
To continue a stopped run, start the loop again. It skips each Trace with the implemented or verified label.
The source of these pages is docs/wiki/ in the repo. Edit the pages there. A workflow overwrites each change that you make in the wiki.
Start
Concepts
Workflow
Reference