# SKILL — {{PROJECT_NAME}} task playbook

> **The "how do I do X here" file.** Common tasks for this repo as repeatable
> recipes: goal → steps → how to verify. When a recipe bites back, the lesson
> graduates to a `§ANCHOR` in [`SCARS.md`](../../../SCARS.md).
>
> **Reading order.** [`ATLAS.md`](../../../ATLAS.md) (*where* things live) →
> [`SCARS.md`](../../../SCARS.md) (*what breaks*) → **this file** (*how* to do tasks).

---

## Table of contents

- [Run the project's tests](#run-tests)
- [Add a feature / change behavior](#add-feature)
- [Add a dependency](#add-dependency)
- [Cut a release](#cut-release)

---

## Tasks

<a id="run-tests"></a>
### Run the project's tests

```
{{TEST_CMD}}
```
Run this after touching runtime or shared modules (SCARS §SMOKE-AFTER-CHANGE).
The smoke subset lives in ATLAS §5.

---

<a id="add-feature"></a>
### Add a feature / change behavior

1. Read the relevant `ATLAS.md` section; cite it in your plan.
2. Make the change in `{{SRC_DIR}}/` — surgical, minimal (CLAUDE.md §3).
3. Add/extend a test that fails before and passes after.
4. Run the tests above.
5. If you changed structure (new module, dep, file moves) → update `ATLAS.md`
   in the **same commit** (SCARS §ATLAS-IS-INDEX).

---

<a id="add-dependency"></a>
### Add a dependency

1. Add it to `{{PRIMARY_BUILD_FILE}}`.
2. Record *why* in `ATLAS.md` §X (external deps) — agents must not modify it blindly.
3. A new external dep is a non-trivial decision → write an ADR (SCARS §ADR-BEFORE-MAJOR).

---

<a id="cut-release"></a>
### Cut a release

_(fill in this project's release steps — e.g. bump version, update CHANGELOG,
tag, push. Cross-link any release gotchas to `SCARS.md`.)_

---

> Add a `### <Task>` + a ToC link for each common task. Keep recipes short;
> push the *failure* knowledge to `SCARS.md` so it stays a clean how-to list.