{"id":51028811,"url":"https://github.com/huifer/zeus","last_synced_at":"2026-06-21T22:01:54.677Z","repository":{"id":349783563,"uuid":"1203879771","full_name":"huifer/zeus","owner":"huifer","description":"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 multi-platform testing (Android/iOS/Chrome) + closed-loop evolution from real production feedback.","archived":false,"fork":false,"pushed_at":"2026-04-07T15:27:22.000Z","size":636,"stargazers_count":12,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-07T15:32:47.539Z","etag":null,"topics":["ai-agents","claude-code","llm","skills"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/huifer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-07T13:24:57.000Z","updated_at":"2026-04-07T15:27:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/huifer/zeus","commit_stats":null,"previous_names":["huifer/zeus"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/huifer/zeus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huifer%2Fzeus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huifer%2Fzeus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huifer%2Fzeus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huifer%2Fzeus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huifer","download_url":"https://codeload.github.com/huifer/zeus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huifer%2Fzeus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34627192,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude-code","llm","skills"],"created_at":"2026-06-21T22:01:53.868Z","updated_at":"2026-06-21T22:01:54.639Z","avatar_url":"https://github.com/huifer.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zeus - AI Project Evolution Operating System\n\n[![Language](https://img.shields.io/badge/language-English%20%7C%20中文-blue)](README.zh-CN.md)\n[![Workflow](https://img.shields.io/badge/workflow-init%E2%86%92brainstorm%E2%86%92plan%E2%86%92execute%E2%86%92feedback-green)](#workflow)\n[![Status](https://img.shields.io/badge/status-active-success)](#)\n[![License](https://img.shields.io/badge/license-MIT-lightgrey)](#license)\n\nStructured, version-aware AI delivery framework for long-running projects.\n\nZeus combines:\n- deterministic planning artifacts (`spec`, `prd`, `task`, `roadmap`),\n- wave-based execution with atomic commits,\n- mandatory attribution loop from production feedback to roadmap evolution.\n\nLanguage: [English](README.md) | [简体中文](README.zh-CN.md)\n\n## Quick Start\n\n```bash\n# 1) Install the commit message hook (one-time)\ncp .zeus/hooks/commit-msg .git/hooks/commit-msg\n\n# 2) Initialize the Zeus project workspace\n/zeus:init\n\n# Optional for brownfield repositories: map the existing codebase first\n/zeus:discover --depth auto\n\n# 3) Build the first design spec\n/zeus:brainstorm --full\n\n# 4) Convert approved spec to executable artifacts\n/zeus:plan\n\n# 5) Run pending tasks in dependency waves\n/zeus:execute\n```\n\n## Workflow\n\nEnglish workflow diagram:\n\n![Zeus Workflow EN](assets/zeus-workflow.en.svg)\n\nChinese workflow diagram:\n\n![Zeus Workflow ZH](assets/zeus-workflow.zh-CN.svg)\n\n## Skill Commands\n\n| Command | Purpose | Main Output |\n|---|---|---|\n| `/zeus:init` | Initialize Zeus workspace and north star metrics | `.zeus/main/config.json`, `evolution.md` |\n| `/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` |\n| `/zeus:brainstorm --full` | Full-scope design dialogue and spec authoring | `.zeus/main/specs/*.md` |\n| `/zeus:brainstorm --feature \u003cname\u003e` | Single-feature design loop | feature spec |\n| `/zeus:plan [--version v2]` | Convert spec to user stories and tasks | `prd.json`, `task.json`, `roadmap.json` |\n| `/zeus:execute [--version v2]` | Execute pending tasks wave by wave | atomic commits, task pass states |\n| `/zeus:test-gen [--version v2] [--platforms android,chrome,ios]` | AI-generate platform test flows from task/prd artifacts | `{version}/tests/*.test.json` |\n| `/zeus:feedback` | Capture feedback and run attribution | `feedback/*.json`, evolution entry |\n| `/zeus:evolve` | Create a new version branch/folder model | `.zeus/vN/*` |\n| `/zeus:status` | Render global status report and next action | health snapshot + recommendation |\n\n## Repository Layout\n\n```text\n.zeus/\n  main/\n    config.json\n    prd.json\n    task.json\n    roadmap.json\n    evolution.md\n    feedback/\n    ai-logs/\n    specs/\n    tests/\n      android.test.json   ← AI-generated, do not edit manually\n      chrome.test.json\n      ios.test.json\n  v2/ ... vN/\n  schemas/\n    config.schema.json\n    codebase-map.schema.json\n    existing-modules.schema.json\n    prd.schema.json\n    task.schema.json\n    roadmap.schema.json\n    spec.schema.json\n    feedback.schema.json\n    ai-log.schema.json\n    test-flow.schema.json\n  scripts/\n    zeus-runner.sh\n    generate-tests.sh\n    collect-metrics.sh\n\n## Brownfield Adoption\n\nFor existing repositories, run this path:\n\n```bash\n# 1) Build codebase context artifacts\n/zeus:discover --version main --depth auto\n\n# 2) Initialize config using discovered context\n/zeus:init --import-existing --version main\n\n# 3) Design and plan a scoped feature against existing modules\n/zeus:brainstorm --feature \u003cname\u003e --version main\n/zeus:plan --version main\n\n# 4) Execute with wave gates\n/zeus:execute --version main\n```\n\nThis keeps Zeus backward-compatible for greenfield projects while adding safe brownfield onboarding.\n  hooks/\n    commit-msg\n\n.claude/\n  skills/zeus-*/SKILL.md\n  agents/*.md\n\nassets/\n  zeus-workflow.en.svg\n  zeus-workflow.zh-CN.svg\n```\n\n## Agent Model\n\nZeus uses phase-specific agents under `.claude/agents`:\n\n- `zeus-researcher`: context discovery and dependency checks\n- `zeus-planner`: spec decomposition and artifact shaping\n- `zeus-executor`: wave execution orchestration with quality gates\n- `zeus-analyst`: attribution confidence and evolution decisions\n- `zeus-docs`: bilingual consistency and docs quality checks\n- `zeus-tester`: AI test case authoring for android / chrome / ios platforms\n\nSkills should delegate intentionally:\n- brainstorming -\u003e researcher\n- plan -\u003e planner\n- execute -\u003e executor\n- test generation -\u003e tester (via `generate-tests.sh`)\n- feedback/evolve -\u003e analyst\n- docs quality checks -\u003e docs\n\n## Testing\n\nZeus uses AI-generated test flows. **Do not write test cases manually.**\n\n```bash\n# Generate test flows for all platforms (after zeus:plan)\nbash .zeus/scripts/generate-tests.sh --version main --platforms android,chrome,ios\n\n# Or via skill\n/zeus:test-gen\n\n# Target a single platform\n/zeus:test-gen --platforms chrome\n\n# Regenerate (overwrite existing)\nbash .zeus/scripts/generate-tests.sh --version main --force\n```\n\nGenerated files live at `.zeus/{version}/tests/{platform}.test.json` and conform to `.zeus/schemas/test-flow.schema.json`.\n\nTest execution uses the native platform toolchain directly:\n\n| Platform | Toolchain |\n|---|---|\n| Android | `adb shell` |\n| Chrome | `chrome-cli` / Chrome DevTools Protocol |\n| iOS | `xcrun simctl` / `libimobiledevice` |\n\nTest flows are regenerated automatically when `/zeus:test-gen` is invoked, and optionally after each execution wave completes.\n\n## AI Log Contract\n\nEach skill execution must append one markdown log in `ai-logs/`:\n\n```markdown\n## Decision Rationale\nWhy this approach was selected.\n\n## Execution Summary\nWhat changed and where.\n\n## Target Impact\nExpected impact on the north star metric.\n```\n\n## Commit Convention\n\n```text\nfeat(T-003): implement user registration form\nfix(T-007): correct session token expiry\ndocs(zeus): update prd from auth-design spec\nchore(zeus): initialize v2 evolution\n```\n\n## Troubleshooting\n\n- If `/zeus:*` commands are not discovered, restart your AI runtime session.\n- If execution stalls, verify `.zeus/scripts/zeus-runner.sh` is executable.\n- If task updates fail, check JSON validity in `.zeus/*/task.json`.\n- If commit hook fails, re-copy `.zeus/hooks/commit-msg` into `.git/hooks/`.\n\n## Contributing\n\n1. Keep prompt specs deterministic and artifact-driven.\n2. Keep shell snippets in English only.\n3. Preserve backward compatibility for core `.zeus` schema files.\n4. Add docs updates for any workflow changes.\n\n## Acknowledgements / 友链\n\n- [LINUX DO](https://linux.do/) — 开源社区支持\n\n## Contact / 交流群\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/image.png\" alt=\"交流群\" width=\"300\" /\u003e\n\u003c/p\u003e\n\n## License\n\nMIT License — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuifer%2Fzeus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuifer%2Fzeus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuifer%2Fzeus/lists"}