Spec-Driven Execution
Driver only. All planning, task format, implementation rules, and validation
live in tlc-spec-driven. This skill does not duplicate them.
What this repo adds
| Delta | Meaning |
|---|---|
| Sub-agent roles | Planner → Implementer → Verifier, each a fresh Composer 2.5 sub-agent (model: composer-2.5). Orchestrator sequences them; never writes spec/code/tests. |
| Single Implementer | One sub-agent runs every task in tasks.md. Skip tlc's per-phase worker offer. |
| Auto-commit in flow | Implementer may commit per task without asking (only while this flow is active). |
| ROADMAP loop | Autonomous mode walks .specs/ROADMAP.md one unchecked phase at a time. |
Orchestrator flow
- Pick phase —
.specs/ROADMAP.md(or loop payload); resume in-flight work from.specs/STATE.md## Handoffif present. - Clean env — free ports 2567 and 4200 before gates.
- Dispatch Planner sub-agent.
- Dispatch Implementer sub-agent (only after Planner artifacts exist under
.specs/features/<feature>/). - Dispatch Verifier sub-agent (always; orchestrator handles fix→re-verify ≤3 iterations per tlc).
- On Verifier PASS — flip ROADMAP
[x], updateSTATE.mdHandoff, commitdocs(spec): mark phase <N> complete in ROADMAP and STATE.
Sub-agent prompts
Sub-agents cannot see this chat. Each prompt is self-contained:
- Activate
tlc-spec-drivenby name and follow it for the assigned role (Specify/Design/Tasks, Execute, or Validate). If the skill cannot be activated, STOP. - Feature context — ROADMAP phase title + goal, feature slug, output dir
.specs/features/<feature>/, repo path/Users/wneto/Dev/nj. - Autonomous mode (loop / unattended) — resolve ambiguities as spec assumptions; no user confirmation gates.
- Project glue (below) — repo inputs tlc does not know about.
- Role footnotes only:
- Implementer: paths to existing
spec.md/design.md/tasks.md; authorized to commit per task; do not run Verifier. - Verifier: git diff/commit range for the feature; Implementer deviation summary if any.
Do not paste tlc templates, reference filenames, or quality rules into the prompt — the skill owns that.
Project glue
Append to every sub-agent prompt. Point at repo docs; do not restate their contents.
.specs/ROADMAP.md— phase scope and dependencies.specs/STATE.md—## Decisions(AD-NNN),## HandoffAGENTS.md— testing contract for this monorepo- L2J Classic reference (parse only, never depend):
~/Dev/L2J_Mobius/L2J_Mobius_Classic_1.0/dist/game/data/