Structured, version-aware AI delivery framework for long-running projects. Deterministic planning (Spec/PRD/Task/Roadmap) + wave-based atomic execution + Git-hook enforcement + zero-manual...
概要
Structured, version-aware AI delivery framework for long-running projects. Zeus combines: - deterministic planning artifacts (spec, prd, task, roadmap), - wave-based execution with atomic commits, - mandatory attribution loop from production feedback to roadmap evolution. bash /zeus:discover --version main --depth auto /zeus:init --import-existing --version main /zeus:brainstorm --feature --version main /zeus:plan --version main Zeus uses phase-specific agents under .claude/agents: - zeus-researcher: context discovery and dependency checks - zeus-planner: spec decomposition and artifact shaping - zeus-executor: wave execution orchestration with quality gates - zeus-analyst: attribution confidence and evolution decisions - zeus-docs: bilingual consistency and docs quality checks - zeus-tester: AI test case authoring for android / chrome / ios platforms Skills should delegate intentionally: - brainstorming -> researcher - plan -> planner - execute -> executor - test generation ->...
README
以下は原文 README の抜粋です。原文を見る。
Zeus - AI Project Evolution Operating System
Structured, version-aware AI delivery framework for long-running projects.
Zeus combines:
- deterministic planning artifacts (
spec,prd,task,roadmap), - wave-based execution with atomic commits,
- mandatory attribution loop from production feedback to roadmap evolution.
Quick Start
# 1) Install the commit message hook (one-time)
cp .zeus/hooks/commit-msg .git/hooks/commit-msg
# 2) Initialize the Zeus project workspace
/zeus:init
# Optional for brownfield repositories: map the existing codebase first
/zeus:discover --depth auto
# 3) Build the first design spec
/zeus:brainstorm --full
# 4) Convert approved spec to executable artifacts
/zeus:plan
# 5) Run pending tasks in dependency waves
/zeus:execute
Workflow
English workflow diagram:
Chinese workflow diagram:
Skill Commands
| Command | Purpose | Main Output |
|---|---|---|
/zeus:init |
Initialize Zeus workspace and north star metrics | .zeus/main/config.json, evolution.md |
/zeus:discover [--version v2] [--depth quick|auto|full] |
Map existing codebase and generate brownfield context artifacts | codebase-map.json, existing-modules.json, tech-inventory.md, architecture.md |
/zeus:brainstorm --full |
Full-scope design dialogue and spec authoring | .zeus/main/specs/*.md |
/zeus:brainstorm --feature |
Single-feature design loop | feature spec |
/zeus:plan [--version v2] |
Convert spec to user stories and tasks | prd.json, task.json, roadmap.json |
/zeus:execute [--version v2] |
Execute pending tasks wave by wave | atomic commits, task pass states |
/zeus:test-gen [--version v2] [--platforms android,chrome,ios] |
AI-generate platform test flows from task/prd artifacts | {version}/tests/*.test.json |
/zeus:feedback |
Capture feedback and run attribution | feedback/*.json, evolution entry |
/zeus:evolve |
Create a new version branch/folder model | .zeus/vN/* |
/zeus:status |
Render global status report and next action | health snapshot + recommendation |
Repository Layout
.zeus/
main/
config.json
prd.json
task.json
roadmap.json
evolution.md
feedback/
ai-logs/
specs/
tests/
android.test.json ← AI-generated, do not edit manually
chrome.test.json
ios.test.json
v2/ ... vN/
schemas/
config.schema.json
codebase-map.schema.json推奨ツール
別のキーワードを試すか、フィルタを外してください。
インストール
npx skillfish add huifer/zeus