AGENTS.md Changes
AGENTS.md teaches an AI helper how to work on the DockB project. The changes tighten up that workflow.
New "Commands" section — adds 3 trigger phrases:
- "start work" — run the whole workflow (A–E)
- "tdd" — run just step C, picking up from a saved plan
- "wrap up" — run just step E
## Commands
- **"start work"** / **"start-work"** — begin the [Workflow](#workflow) section, starting at
step 1 (Understand the request) through step 9. Do not run any other workflow or skill.
- **"tdd"** / **"TDD"** — begin the [3. Build — the TDD loop](#3-build--the-tdd-loop) section,
working on the next uncompleted section of the plan breakdown.
- **"wrap up"** / **"wrap-up"** — begin the [Wrap-up](#wrap-up) section.
I had to explicitly tell it not to use my Claude skills, because that would muddy the water, so under the "Core principles" section:
- Never use tools, skills, or any files under `/home/brian-modra/.claude`.
Workflow got a stricter structure:
- Steps renamed from numbers (1, 2, 3) to letters (A, B, C, D, E).
- The AI must announce which step it's on (e.g. "C.3") and give a short summary before moving on.
- Plans are now saved to a file (~/.cache/dockb/plan.md) so a later "tdd" run can pick up where it left off, instead of just keeping them in memory.
- After committing each section, the AI must pause and ask whether to continue or wrap up.
- "Loop" and "Wrap-up" promoted to full steps D and E.
Smaller clarifications:
- Replaced the Executive Summary "if it exists, replace it" with "replace it wherever it is, and put it at the top".
- Added the rule that a "tdd" run asks the user if the plan file is missing or outdated.