zeus: Skill for Claude Code

Zeus Plan - Spec to Executable Artifacts

Convert an approved spec into version-scoped stories and tasks with deterministic IDs and dependency waves.

Preconditions

• Target spec exists and is approved.
• .zeus/{version}/config.json exists.
• .zeus/{version}/prd.json, task.json, and roadmap.json are writable.

Inputs

• --spec <filename> (optional, default latest spec)
• --version vN (optional, default main)

Deterministic workflow

1) Load context and reserve IDs

Read:

• selected spec
• version config
• existing prd.json
• existing task.json

Reserve next IDs:

• US-{NNN} from prd.json
• T-{NNN} from task.json
• M-{NNN} from roadmap.json milestones

2) Create user stories

Extract 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:

• high: direct north star impact
• medium: critical support path
• low: optimization or edge behavior

3) Create executable tasks

Generate small, independently executable units.

Task types:

• infra
• api
• frontend
• docs

Task 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:

• If task modifies existing modules, fill refactor_of with a stable module path or identifier.
• If task depends on existing code not represented by Zeus task IDs, list those in depends_on_existing.
• Keep both fields optional for backward compatibility.