ref-sp-agents-local-taskslisted
Install: claude install-skill swiftpostlabs/agentic-tools
# 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 kebab-case folder per substantial task, each carrying a `README.md` whose frontmatter records an internal `status`. Each folder lives in exactly one lifecycle subfolder — `new/`, `open/`, or `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/new/<task-name>/`, or moving one between `new/`, `open/`, and `closed/`.
- Setting or updating a task's frontmatter `status`.
- 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, `TODO.md` syntax, and frontmatter `status`.
- `tool-sp-handle-agents-local-tasks` — actually working the backlog: picking the next item, doing
it, moving the folder. Read this sk