← ClaudeAtlas

workspace-planslisted

Use this skill when writing, revising, or executing a workspace plan — the plan/README.md + phase-N-<slug>.md format the dashboard ingests. Don't use it for ad-hoc todo lists or in-repo design docs.
atretyak1985/swarmery · ★ 7 · AI & Automation · score 81
Install: claude install-skill atretyak1985/swarmery
# Purpose The private workspace plan format is a contract: the control plane parses it to render plan progress, phase summaries, and spec coverage. A plan that deviates from the format ships work the operator cannot see. # The contract (never violate) - Plans live at `<workspace>/<project>/workspace/working/{YYYY}/{MM}/{DD}/{slug}/plan/`; task-id `yyyy-mm-dd-slug` is derived from the path — never encode the date in the folder name. - `plan/README.md` — objective, architecture decisions with real file paths, the sequencing table with exactly these header cells: `| # | Phase | Doc | Depends on |`, risks, Definition of Done. - `plan/phase-N-<slug>.md` per phase (flat; `step-NN-*.md` is legacy read-compat only) — each with a self-contained copy-paste executor prompt whose Verify block is file-backed (a repo script or test by absolute path; no heredoc, `python3 -` or `node -e` — see `resources/plan-format.md`), `- [ ]` acceptance criteria checkable by command or boolean inspection, and an empty `## Completion Report` section as the LAST section. - A `## Forecast` section in each phase doc, immediately before that stub, holding one `kind: prior` yaml block (see `resources/plan-format.md`). It is a prediction, not a limit: do whatever the phase actually needs. - `plan/manifest.json` — machine-readable phase DAG (must pass `python3 -m json.tool`). - Optional `plan/spec.md` with `- [ ] **SC-n** — <criterion>` lines; then every phase doc carries a `**Covers