en un clic
zeus-plan
// Convert a spec document into structured prd.json user stories and task.json execution units. Called automatically by zeus-brainstorm, but can also be invoked directly. Supports --version flag to target v2/v3/v4 folders.
// Convert a spec document into structured prd.json user stories and task.json execution units. Called automatically by zeus-brainstorm, but can also be invoked directly. Supports --version flag to target v2/v3/v4 folders.
| name | zeus-plan |
| description | Convert a spec document into structured prd.json user stories and task.json execution units. Called automatically by zeus-brainstorm, but can also be invoked directly. Supports --version flag to target v2/v3/v4 folders. |
Convert an approved spec into version-scoped stories and tasks with deterministic IDs and dependency waves.
.zeus/{version}/config.json exists..zeus/{version}/prd.json, task.json, and roadmap.json are writable.--spec <filename> (optional, default latest spec)--version vN (optional, default main)Read:
prd.jsontask.jsonReserve next IDs:
US-{NNN} from prd.jsonT-{NNN} from task.jsonM-{NNN} from roadmap.json milestonesExtract from acceptance criteria and role/goal language in spec.
Required story shape:
{
"id": "US-001",
"title": "One-line story title",
"description": "As a <role>, I need <capability> so that <outcome>",
"acceptance_criteria": ["Given/When/Then style criterion"],
"priority": "high",
"version_scope": "main",
"passes": false,
"created_from_spec": "2026-04-07-auth-design.md",
"created_at": "2026-04-07T00:00:00.000Z"
}
Priority policy:
Generate small, independently executable units.
Task types:
infraapifrontenddocsTask schema:
{
"id": "T-001",
"story_id": "US-001",
"type": "api",
"title": "Implement POST /api/auth/login",
"description": "Include validation, error mapping, and audit logging.",
"files": ["src/app/api/auth/login/route.ts"],
"depends_on": [],
"refactor_of": null,
"depends_on_existing": [],
"passes": false,
"commit_sha": null,
"ai_log_ref": null,
"wave": null,
"created_at": "2026-04-07T00:00:00.000Z"
}
Brownfield policy:
refactor_of with a stable module path or identifier.depends_on_existing.Build dependency DAG from depends_on and assign wave numbers:
Reject cyclic dependencies and force correction before write.
Add or update milestone with:
spec_refstatus: plannedWrite updated:
.zeus/{version}/prd.json.zeus/{version}/task.json.zeus/{version}/roadmap.jsongit add .zeus/{version}/prd.json .zeus/{version}/task.json .zeus/{version}/roadmap.json
git commit -m "docs(zeus): update prd and task from {spec-name}"
Create .zeus/{version}/ai-logs/{ISO-ts}-plan.md with the 3-section contract.
Return:
/zeus:execute.After printing the summary, prompt the user:
Generate test flows now? [yes/no]
(Platforms: android, chrome, ios — runs /zeus:test-gen automatically)
/zeus:test-gen --version {version} immediately./zeus:test-gen at any time before executing.Use zeus-planner for decomposition quality checks and dependency sanity verification.
Brainstorm features or run full project planning through structured dialogue. Use --full for initial project-wide planning (includes north star metrics if not set), or --feature <name> for a single feature. Always asks one question at a time. Invokes zeus-plan automatically after spec is approved.
Map an existing (brownfield) codebase into deterministic Zeus artifacts under .zeus/{version}/ so downstream skills can reuse real project context.
Execute all pending tasks in task.json using the zeus-runner.sh shell loop. Tasks are grouped into dependency waves and run with fresh claude CLI subagents. Each task gets an atomic git commit and a mandatory ai-log entry. Supports --version flag for v2/v3/v4 execution.
Initialize a new Zeus project. Creates .zeus/main/ directory structure, sets up config.json with north star metrics, and writes the first evolution.md entry. Use this FIRST before any other zeus skill.
Display a full status report of the Zeus project — all active versions, task progress, recent feedback attribution, evolution history, and next recommended action.
Create a new version folder (.zeus/v2/, .zeus/v3/ etc.) when user feedback reveals needs that can't be met by the main version. Inherits main config and declares differences. Records everything in evolution.md.