ref-sp-agents-local-taskslisted

# Agents Local Tasks ## Purpose Define how this repo uses `.agents/tasks/` as a gitignored local workspace with two complementary layers: - **`TODO.md`** — a lightweight notes and small-tasks list for quick items that do not need lifecycle tracking. - **Tracked task folders** — one date-prefixed, kebab-case folder per substantial task, each carrying a `README.md` whose frontmatter records `status`, `created`, `updated`, and (once closed) a prose `outcome`. Each folder lives in exactly one lifecycle subfolder — `10-new/`, `20-open/`, or `90-closed/` — and moves between them as the task progresses. Treat `.agents/tasks/` for task tracking and `.agents/playground/` for scratch artifacts as the default paired local workspaces unless the current repo explicitly documents a different convention. ## When to use this skill - Reading or updating `.agents/tasks/TODO.md`. - Creating a tracked task folder under `.agents/tasks/10-new/<YYYY-MM-DD>-<task-name>/`, or moving one between `10-new/`, `20-open/`, and `90-closed/`. - Setting or updating a task's frontmatter `status`, `updated`, or `outcome`. - Storing temporary working files such as `pr-description.md`, `notes.md`, `validation.md`, or `plan.md` inside a task folder. - Reviewing whether local task files still match the active work. ## Scope boundaries This skill owns the **format and conventions** of `.agents/tasks/`: the directory model, the lifecycle subfolders, folder naming, `TODO.md` syntax, and the frontmatter fields.