# Matt Pocock Published Skills — Resources

## Knowledge

Primary sources live **in this repo**. Prefer these over blog summaries or model memory.

### System & authority

- [`.claude-plugin/plugin.json`](./.claude-plugin/plugin.json)  
  **Published set authority.** Use for: which skills ship; version; exact paths.
- [`CLAUDE.md`](./CLAUDE.md) / Agents rules  
  Use for: bucket rules (promoted vs not), docs sync obligations, ask-matt as router.
- [`.agents/invocation.md`](./.agents/invocation.md)  
  Use for: user-invoked vs model-invoked contract; openai.yaml pairing; prose invocation rules.
- [`.agents/adr/0002-ship-as-a-claude-code-plugin.md`](./.agents/adr/0002-ship-as-a-claude-code-plugin.md)  
  Use for: why plugin.json lists paths one-by-one; Codex deferred.
- [`CONTEXT.md`](./CONTEXT.md)  
  Use for: domain terms Issue tracker / Issue / Decision ticket / Triage role.
- [`README.md`](./README.md)  
  Use for: human-facing inventory split User-invoked / Model-invoked; failure-mode framing.

### Maps & meta-skills

- [`skills/engineering/ask-matt/SKILL.md`](./skills/engineering/ask-matt/SKILL.md)  
  **Flow map of record.** Use for: main flow, on-ramps, standalone, context hygiene, smart zone.
- [`skills/productivity/writing-great-skills/SKILL.md`](./skills/productivity/writing-great-skills/SKILL.md) + [`GLOSSARY.md`](./skills/productivity/writing-great-skills/GLOSSARY.md)  
  Use for: how skills are designed (predictability, loads, failure modes) — author-level editing vocabulary.
- Human docs mirror: `docs/engineering/*`, `docs/productivity/*` and published pages `https://aihero.dev/skills-<name>`  
  Use for: narrative “when to reach for it”; agent truth remains each skill’s `SKILL.md`.

### Per-skill sources (always open SKILL.md + siblings)

Every published path is under `skills/engineering/` or `skills/productivity/`. For each deep dive, the lesson must cite that folder’s `SKILL.md` and any linked sibling (e.g. `tdd/tests.md`, `domain-modeling/CONTEXT-FORMAT.md`, `setup-matt-pocock-skills/issue-tracker-*.md`).

Key high-traffic siblings:

- `skills/engineering/setup-matt-pocock-skills/` — templates for `docs/agents/*`
- `skills/engineering/domain-modeling/CONTEXT-FORMAT.md`, `ADR-FORMAT.md`
- `skills/engineering/triage/AGENT-BRIEF.md`, `OUT-OF-SCOPE.md`
- `skills/engineering/tdd/tests.md`, `mocking.md`
- `skills/engineering/prototype/LOGIC.md`, `UI.md`
- `skills/engineering/codebase-design/DEEPENING.md`, `DESIGN-IT-TWICE.md`
- `skills/engineering/improve-codebase-architecture/HTML-REPORT.md`

### External (secondary; for vocabulary roots, not skill behaviour)

- [Tracer Bullets — The Pragmatic Programmer (concept)](https://pragprog.com/titles/tpp20/the-pragmatic-programmer-20th-anniversary-edition/)  
  Use for: why to-tickets wants vertical end-to-end slices.
- [Martin Fowler — Code Smells / Refactoring](https://martinfowler.com/books/refactoring.html)  
  Use for: code-review Standards baseline smells.
- [aihero.dev skills dictionary / smart zone](https://www.aihero.dev/ai-coding-dictionary/smart-zone)  
  Use for: context hygiene / smart zone as named in ask-matt.

## Wisdom (Communities)

- [mattpocock/skills GitHub Discussions / Issues](https://github.com/mattpocock/skills)  
  Use for: how maintainers intend a skill to behave; open design debates.
- [AI Hero / Total TypeScript community channels](https://www.aihero.dev)  
  Use for: practitioner reports on the flow in real codebases.

## Gaps

- No single official “side-effect matrix” outside the SKILL.md bodies — we synthesize one in `reference/` from the sources above and must re-verify when skills change.
- Behaviour of tracker-specific “Wayfinding operations” lives in **generated** `docs/agents/issue-tracker.md` after setup, not always in the skill folder itself.