From 3370fb0af12ec887e8e36c8aa59a7e0f3084d6d3 Mon Sep 17 00:00:00 2001
From: Preston Cabe <prestoncabe@gmail.com>
Date: Tue, 3 Nov 2026 21:08:33 -0500
Subject: [PATCH] Add Matt Pocock Skills setup files

---
 AGENTS.md                    | 14 ++++++++++++++
 docs/agents/domain.md        | 20 ++++++++++++++++++++
 docs/agents/issue-tracker.md | 35 +++++++++++++++++++++++++++++++++++
 docs/agents/triage-labels.md | 11 +++++++++++
 4 files changed, 80 insertions(+)
 create mode 100644 docs/agents/domain.md
 create mode 100644 docs/agents/issue-tracker.md
 create mode 100644 docs/agents/triage-labels.md

diff --git a/AGENTS.md b/AGENTS.md
index 15b9c1a2..955c8867 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -41,3 +41,17 @@ Repository skills are stored in `.agents/skills/` using the portable Agent Skill
 - `new-dmn-check`: create a reusable check DMN and its Bruno tests.
 
 Claude compatibility is provided through the `.claude/skills` symlink to `.agents/skills`.
+
+## Agent skills
+
+### Issue tracker
+
+Track issues and specs in GitHub Issues. Read `docs/agents/issue-tracker.md` before tracker operations.
+
+### Triage labels
+
+Use the five default triage labels. Read `docs/agents/triage-labels.md` when assigning triage roles.
+
+### Domain docs
+
+Use a single-context layout. Read `docs/agents/domain.md` before exploring domain concepts or architectural decisions.
diff --git a/docs/agents/domain.md b/docs/agents/domain.md
new file mode 100644
index 00000000..91cdb2f0
--- /dev/null
+++ b/docs/agents/domain.md
@@ -0,0 +1,20 @@
+# Domain docs
+
+## Layout and reading rules
+
+Use one root `GLOSSARY.md` and `docs/adr/` for repository-wide decisions.
+Before exploring, read the glossary and ADRs relevant to the work.
+
+If these files are absent, proceed silently. The domain-modeling skill
+creates them as terms and decisions are resolved.
+
+## Vocabulary
+
+Use the glossary's terms in issues, proposals, hypotheses, and tests.
+If a concept is missing, reconsider the terminology or note the gap
+for domain-modeling.
+
+## Decisions
+
+Surface conflicts with existing ADRs explicitly, identifying the ADR
+and explaining why the decision may need reconsideration.
diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md
new file mode 100644
index 00000000..6c35a054
--- /dev/null
+++ b/docs/agents/issue-tracker.md
@@ -0,0 +1,35 @@
+# Issue tracker: GitHub
+
+Issues and specs live in CodeForPhilly/benefit-decision-toolkit.
+Use the `gh` CLI from this checkout.
+
+## Operations
+
+- Read: `gh issue view <number> --json number,title,body,labels,comments`.
+- List: `gh issue list --state open`, with relevant label filters.
+- Create: `gh issue create --title "..." --body-file <file>`.
+- Comment: `gh issue comment <number> --body-file <file>`.
+- Label: `gh issue edit <number> --add-label "..."` or `--remove-label "..."`.
+- Close: post the explanation as a comment, then run `gh issue close <number>`.
+
+Use files with actual newlines for multiline bodies and comments.
+
+Before the first issue creation in a session, verify the target with
+`gh repo view --json nameWithOwner`. The expected repository is
+`CodeForPhilly/benefit-decision-toolkit`; resolve any mismatch before writing.
+
+## Relationships
+
+Use native GitHub sub-issues and issue dependencies when supported.
+Otherwise, put `Part of #<parent>` and `Blocked by: #<number>` at the top
+of the child issue body and link children in the parent's task list.
+A ticket is unblocked when every blocker is closed.
+
+## Pull requests as a triage surface
+
+**PRs as a request surface: no.**
+
+## Skill terminology
+
+“Publish to the issue tracker” means create a GitHub issue.
+“Fetch the relevant ticket” means read the GitHub issue.
diff --git a/docs/agents/triage-labels.md b/docs/agents/triage-labels.md
new file mode 100644
index 00000000..ea9b603f
--- /dev/null
+++ b/docs/agents/triage-labels.md
@@ -0,0 +1,11 @@
+# Triage labels
+
+| Canonical role | Tracker label | Meaning |
+| --- | --- | --- |
+| needs-triage | needs-triage | Maintainer needs to evaluate |
+| needs-info | needs-info | Waiting on reporter information |
+| ready-for-agent | ready-for-agent | Fully specified for agent implementation |
+| ready-for-human | ready-for-human | Requires human implementation |
+| wontfix | wontfix | Will not be actioned |
+
+When a skill names a triage role, apply the corresponding tracker label.