Shared domain vocabulary for the repository. Defines Issue tracker, Issue, Decision ticket and Triage role, lists the terms to avoid, maps how the entities relate and records resolved ambiguities, so agent and human use one language instead of drifting synonyms.
mattpocock/skills / CONTEXT.md — Shared domain vocabulary for the repository
Snapshot 2026-08-07 09:26:27 UTC · version 1
Research document
MDRSS snapshot ·
CONTEXT.mdfrom mattpocock/skills · audience: AI agents · License: MIT (Matt Pocock).Shared domain vocabulary for the repository.
Relative links are pinned to commit
84fdeffd12f2.
Matt Pocock Skills
A collection of agent skills (slash commands and behaviors) loaded by Claude Code. Skills are organized into buckets and consumed by per-repo configuration emitted by /setup-matt-pocock-skills.
Language
Issue tracker:
The tool that hosts a repo's issues — GitHub Issues, Linear, a local .scratch/ markdown convention, or similar. Skills like to-tickets, to-spec, and triage read from and write to it.
Avoid: backlog manager, backlog backend, issue host
Issue:
A single tracked unit of work inside an Issue tracker — a bug, task, spec, or slice produced by to-tickets.
Avoid: ticket (use only when quoting external systems that call them tickets, or for a Decision ticket — see below)
Decision ticket:
A wayfinder unit — a child Issue of a wayfinder:map holding a question whose resolution is a decision, not a slice of a build to execute. The decision qualifier is what keeps it distinct from an implementation ticket; wayfinder introduces the term, then uses "ticket".
Triage role:
A canonical state-machine label applied to an Issue during triage (e.g. needs-triage, ready-for-afk). Each role maps to a real label string in the Issue tracker via docs/agents/triage-labels.md.
Relationships
- An Issue tracker holds many Issues
- An Issue carries one Triage role at a time
- A Decision ticket is an Issue (a child of a
wayfinder:map)
Flagged ambiguities
- "backlog" was previously used to mean both the tool hosting issues and the body of work inside it — resolved: the tool is the Issue tracker; "backlog" is no longer used as a domain term.
- "backlog backend" / "backlog manager" — resolved: collapsed into Issue tracker.
Snapshot metrics: 1786 B · 31 lines · ~443 tokens · 4 headings · links pinned to 84fdeffd12f2.
Why MDRSS assigned this score
- 1 evidence URL(s) found in Markdown
- evidence comes from multiple domains
- some evidence URLs look like primary-source hosts
Evidence (5)
- https://github.com/mattpocock/skills/blob/84fdeffd12f2ee307994d1eb6feb48173b6e0502/CONTEXT.md
- https://raw.githubusercontent.com/mattpocock/skills/main/CONTEXT.md
- https://github.com/mattpocock/skills
- https://github.com/mattpocock/skills/blob/84fdeffd12f2ee307994d1eb6feb48173b6e0502/LICENSE
- https://opensource.org/licenses/MIT
concept:developer-toolingorg:collider-club Discussion 0
Sign in to join the discussion.