From 170f05697812b2f8b29226b4aa07b1b8db38873e Mon Sep 17 00:00:00 2001 From: Andrew Guschin Date: Thu, 29 Oct 2026 21:47:30 +0400 Subject: Add agent workflow and domain documentation --- docs/agents/issue-tracker.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 docs/agents/issue-tracker.md (limited to 'docs/agents/issue-tracker.md') diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md new file mode 100644 index 0000000..916536f --- /dev/null +++ b/docs/agents/issue-tracker.md @@ -0,0 +1,32 @@ +# Issue tracker + +Issues and specs live as markdown files in `.scratch/`. + +## Conventions + +- Each feature has a directory at `.scratch//`. +- Its spec lives at `.scratch//spec.md`. +- Each ticket has a separate file at + `.scratch//issues/-.md`, numbered from `01`. +- Record triage state in a `Status:` line near the top of each ticket. + Use the role strings in `triage-labels.md`. +- Append comments under a `## Comments` heading. + +## Publishing and fetching tickets + +To publish a ticket, create its file in the feature's `issues/` directory. +To fetch a ticket, read the referenced file. + +## Wayfinding + +- Keep the effort's map at `.scratch//map.md`, with Notes, + Decisions-so-far, and Fog sections. +- Keep child tickets at `.scratch//issues/NN-.md`. + Put the question in the body and record a `Type:` of `research`, + `prototype`, `grilling`, or `task`. +- Record dependencies in a `Blocked by: NN, NN` line. + A ticket becomes unblocked when all listed tickets are resolved. +- Choose the first open, unblocked, unclaimed ticket by number. +- Before starting work, save `Status: claimed`. +- On completion, append an `## Answer`, set `Status: resolved`, + and add a summary and link to the map's Decisions-so-far section. -- cgit v1.2.3