path-scope-examplelisted
Install: claude install-skill DATA-AI-XYZ/Tandem
# path-scope-example (reference: directory-scoped skill)
This skill is the kit's **worked example of `paths:` scoping** (ADR-0010, proven by STORY-17.2.01). Unlike every other Tandem skill — which is globally relevant and explicitly slash-invoked — this one is bound by its `paths:` frontmatter to **`_00-Project-Management/40-Decisions/`**, so Claude auto-loads it only while reading/writing files in that directory. Outside the decisions folder it stays silent.
It is intentionally minimal and doubles as a genuine, directory-local helper: a quick ADR-authoring checklist.
## When this activates
Auto-loads when you touch a file under `_00-Project-Management/40-Decisions/` (e.g. creating `ADR-0077-*.md`). It does **not** auto-load when you're working in `32-Stories/`, `skills/`, or anywhere else — that's the whole point of path-scoping.
## ADR-authoring reminder (the local concern)
1. **Number sequentially across the whole project.** Glob `ADR-*.md` in this folder, take the max `NNNN`, add 1. No folder grouping.
2. **Start from the template** — `91-Templates/ADR.template.md`. Don't redraft headings from memory.
3. **Record the decision in the same response** as the work that forced it (ADR-on-the-spot).
4. **Link back** — add the new `ADR-NNNN` to the originating story's `decisions:` frontmatter array.
5. **Commit, don't hedge** — an ADR commits to one option; list the rejected ones under `## Alternatives considered`.
## How to reuse this pattern
To make one of your own ski