zhixing-system/docs/agents/issue-tracker.md

Issue tracker: Local Markdown

Issues and specs for this repo live as markdown files in .scratch/.

Conventions

• One feature per directory: .scratch/<feature-slug>/
• The spec is .scratch/<feature-slug>/spec.md
• Implementation issues are one file per ticket at .scratch/<feature-slug>/issues/<NN>-<slug>.md, numbered from 01.
• A ticket may include a Status: line near the top, using a simple project-defined state such as open, in-progress, blocked, or done.
• Comments and conversation history append to the bottom under a ## Comments heading.

When a skill says "publish to the issue tracker"

Create a new file under .scratch/<feature-slug>/.

When a skill says "fetch the relevant ticket"

Read the referenced markdown path.