// 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.
| name | zeus-evolve |
| description | 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. |
Create a new version track when feedback indicates structural divergence from current roadmap.
.zeus/main/config.json exists and is writable.Collect:
Detect latest existing vN and choose next available by default.
If --version is provided, validate uniqueness.
Display summary and require user confirmation.
mkdir -p .zeus/v{N}/feedback
mkdir -p .zeus/v{N}/ai-logs
mkdir -p .zeus/v{N}/specs
Create .zeus/v{N}/config.json with:
inherits: main,overrides.description documenting strategic difference.Create:
prd.jsontask.jsonroadmap.jsonui-design.mdevolution.mdUpdate .zeus/main/config.json versions.active and versions.folders.
EVOLVE entry to .zeus/main/evolution.mdINIT entry in .zeus/v{N}/evolution.mdIf user opts in:
git checkout -b zeus/v{N}-{slug}
git add .zeus/v{N}/ .zeus/main/config.json .zeus/main/evolution.md
git commit -m "chore(zeus): initialize v{N} evolution - {reason}"
Create .zeus/v{N}/ai-logs/{ISO-ts}-evolve.md with 3-section contract.
.zeus/vN/ workspace,Use zeus-analyst to verify evolution confidence and boundary rationale.
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.
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.
Display a full status report of the Zeus project — all active versions, task progress, recent feedback attribution, evolution history, and next recommended action.