← ClaudeAtlas

powdermonkeylisted

Drive PowderMonkey from the supervisor shell (author & load plans, inspect/edit the vocabulary via the API, start/land sessions, reconcile) or execute a task in a worktree (commit finished phases with PM-Phase trailers). Use whenever working with PowderMonkey, a Goal/Milestone/Task/Phase, or PM-Phase / PM-Task trailers.
zmaril/powdermonkey · ★ 0 · AI & Automation · score 56
Install: claude install-skill zmaril/powdermonkey
# PowderMonkey PowderMonkey is a single-operator tool for long-term solo dev. It tracks work as **Goals → Milestones → Tasks → Phases**, and runs each task as a **Session** — either `local` (a git worktree on `pm/task-<id>`) or `remote` (`claude --remote`). The supervisor runs on `main`, owns the *desired* plan, and **never executes work itself**. Progress is read off `main`; nothing self-reports. The API base URL is in `$PM_URL` (default `http://localhost:4500`). There are two roles. You're in the **supervisor shell** (repo dir) → see *Driving*. You're in a **`pm/task-<id>` worktree** → see *Working a task*. ## Driving PowderMonkey (supervisor shell) **Author a plan.** Plans are a nested, id-less tree; the loader assigns ids and wires foreign keys. `POST $PM_URL/plan`: ```json { "goals": [{ "title": "...", "objective": "...", "milestones": [{ "title": "...", "tasks": [{ "title": "...", "phases": [{ "name": "write tests" }, { "name": "implement" }] }] }] }] } ``` Validation is strict (TypeBox); a malformed plan returns 422. Don't include ids — they're assigned. **Inspect / edit.** Every entity has full CRUD: `GET/POST/PATCH/DELETE $PM_URL/{goals|milestones|tasks|phases|sessions}` (and `/:id`). `DELETE` is a **soft delete** (sets `archived_at`, hides from lists); `?archived=true` includes archived; `POST /{entity}/:id/restore` un-archives. Use these to refine a plan after loading it. **Run & land.** `POST $PM_URL/tasks