dot_agents/skills/setup-matt-pocock-skills/issue-tracker-local.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`, never a single combined tickets file
- Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings)
- Comments and conversation history append to the bottom of the file under a `## Comments` heading

## When a skill says "publish to the issue tracker"

Create a new file under `.scratch/<feature-slug>/` (creating the directory if needed).

## When a skill says "fetch the relevant ticket"

Read the file at the referenced path. The user will normally pass the path or the issue number directly.

## Wayfinding operations

Used by `/wayfinder`. The **map** is a file with one **child** file per ticket.

- **Map**: `.scratch/<effort>/map.md` (the Notes / Decisions-so-far / Fog body).
- **Child ticket**: `.scratch/<effort>/issues/NN-<slug>.md`, numbered from `01`, with the question in the body. A `Type:` line records the ticket type (`research`/`prototype`/`grilling`/`task`); a `Status:` line records `claimed`/`resolved`.
- **Blocking**: a `Blocked by: NN, NN` line near the top. A ticket is unblocked when every file it lists is `resolved`.
- **Frontier**: scan `.scratch/<effort>/issues/` for files that are open, unblocked, and unclaimed; first by number wins.
- **Claim**: set `Status: claimed` and save before any work.
- **Resolve**: append the answer under an `## Answer` heading, set `Status: resolved`, then append a context pointer (gist + link) to the map's Decisions-so-far in `map.md`.
shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents 2026-08-10 15:15:06 -04:00			`# Issue tracker: Local Markdown`

chore(agents): update skill metadata timestamps, source URLs, and documentation wording across dot_agents files 2026-08-13 21:04:10 -04:00			Issues and specs for this repo live as markdown files in `.scratch/`.
shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents 2026-08-10 15:15:06 -04:00
			`## Conventions`

			- One feature per directory: `.scratch/<feature-slug>/`
			- The spec is `.scratch/<feature-slug>/spec.md`
chs: re-add drifted files 2026-08-20 14:12:31 -04:00			- Implementation issues are one file per ticket at `.scratch/<feature-slug>/issues/<NN>-<slug>.md`, numbered from `01`, never a single combined tickets file
shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents 2026-08-10 15:15:06 -04:00			- Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings)
			- Comments and conversation history append to the bottom of the file under a `## Comments` heading

			`## When a skill says "publish to the issue tracker"`

			Create a new file under `.scratch/<feature-slug>/` (creating the directory if needed).

			`## When a skill says "fetch the relevant ticket"`

			`Read the file at the referenced path. The user will normally pass the path or the issue number directly.`

			`## Wayfinding operations`

			Used by `/wayfinder`. The map is a file with one child file per ticket.

chs: re-add drifted files 2026-08-20 14:12:31 -04:00			- Map: `.scratch/<effort>/map.md` (the Notes / Decisions-so-far / Fog body).
shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents 2026-08-10 15:15:06 -04:00			- Child ticket: `.scratch/<effort>/issues/NN-<slug>.md`, numbered from `01`, with the question in the body. A `Type:` line records the ticket type (`research`/`prototype`/`grilling`/`task`); a `Status:` line records `claimed`/`resolved`.
			- Blocking: a `Blocked by: NN, NN` line near the top. A ticket is unblocked when every file it lists is `resolved`.
			- Frontier: scan `.scratch/<effort>/issues/` for files that are open, unblocked, and unclaimed; first by number wins.
			- Claim: set `Status: claimed` and save before any work.
			- Resolve: append the answer under an `## Answer` heading, set `Status: resolved`, then append a context pointer (gist + link) to the map's Decisions-so-far in `map.md`.