{
  "markdown": "# ZAC — Zhong's Agentic Coding\n\nA [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugin for **Human-In-The-Loop iterative development** with progressive disclosure and deterministic workflow orchestration.\n\nZAC automates the scaffold → implement → verify cycle so you can focus on what matters — deciding *what* to build, not *how* to run the loop.\n\n## How It Works\n\nZAC implements a **state machine** that chains Claude Code background sessions together via Stop hooks:\n\n```\nscaffold → autopilot → run ──┐\n                              │\n                     claude -p decision\n                              │\n                  ┌───────────┴───────────┐\n                  │                       │\n             more F-Ns               all done\n                  │                       │\n                  ▼                       ▼\n             autopilot → run         summarize → done\n             (next item)  (verify)\n```\n\n1. **scaffold** — Set up project context and generate the feature breakdown\n2. **autopilot** — Implement the next feature point (F-N) autonomously\n3. **run** — Verify: lint, type-check, test, edge cases, commit\n4. **decide** — After `run`, a lightweight `claude -p` call checks if more feature points remain\n5. **summarize** — All features done; generate final summary and update roadmap\n\nEach phase runs as an isolated `claude --bg` session. When a session ends, the Stop hook reads `.zac/sessions.json`, identifies which phase just finished, and automatically launches the next one. On `StopFailure`, the same phase is retried (up to 3 times).\n\n## Installation\n\n### Option 1: Install from marketplace (recommended)\n\nAdd the marketplace first, then install the plugin:\n\n```bash\n# Add the marketplace\nclaude plugin marketplace add im-zhong/zac\n\n# Install the plugin from marketplace\nclaude plugin install zac@zhongs-plugin-marketplace\n```\n\n### Option 2: Install from official marketplace\n\n```bash\n# Install from the official Claude Code marketplace\nclaude plugin install zac\n```\n\n### Post-install (recommended)\n\n```bash\n# Install LSP servers\nnpm install -g typescript-language-server typescript\nnpm install -g pyright\n```\n\n## Update\n\n```bash\nclaude plugin marketplace update zhongs-plugin-marketplace\nclaude plugin uninstall zac@zhongs-plugin-marketplace\nclaude plugin install zac@zhongs-plugin-marketplace\n```\n\n## Usage\n\n### Start a dev flow\n\n```\n/zac:start-dev                    # Start from scaffold\n/zac:start-dev --phase autopilot  # Resume from a specific phase\n/zac:start-dev --phase run --retry # Retry a failed phase\n```\n\n### Check project status\n\n```\n/zac:dev-status          # Current iteration, cycle history, document index\n/zac:dev-status iter 2   # Jump to iteration 2 details\n```\n\n### Study a topic\n\n```\n/zac:study React Server Components\n/zac:study \"Python async/await\" --mode autonomous\n```\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| `start-dev` | Launch the automated dev-flow workflow |\n| `scaffold` | Set up project context and feature breakdown |\n| `dev-loop` | Autonomous develop-and-verify loop for a single item |\n| `run` | Quality gate: lint, type-check, test, edge cases, commit |\n| `fix` | Fix issues found during verification |\n| `progressive-plan` | Progressive planning with iterative refinement |\n| `pre-dev` | Pre-development setup and context gathering |\n| `dev-status` | Read-only project state viewer |\n| `summarize` | Generate iteration summary and update roadmap |\n| `study` | Research a topic with interactive teaching and demos |\n| `e2e-walkthrough` | End-to-end walkthrough of a feature |\n\n## Architecture\n\n```\nzac/                              ← Plugin root\n├── .claude-plugin/\n│   └── plugin.json               ← Plugin manifest\n├── scripts/\n│   ├── start-dev.sh              ← Launch a dev-flow phase as bg session\n│   └── stop-hook.sh              ← Handle Stop/StopFailure, drive state machine\n├── skills/\n│   ├── start-dev/SKILL.md\n│   ├── scaffold/SKILL.md\n│   ├── dev-loop/SKILL.md\n│   ├── run/SKILL.md\n│   ├── fix/SKILL.md\n│   ├── progressive-plan/SKILL.md\n│   ├── pre-dev/SKILL.md\n│   ├── dev-status/SKILL.md\n│   ├── summarize/SKILL.md\n│   ├── study/SKILL.md\n│   └── e2e-walkthrough/SKILL.md\n├── agents/\n│   └── study-agent.md            ← Research & teaching agent\n├── hooks/\n│   └── hooks.json                ← Stop/StopFailure hook config\n└── docs/\n    └── superpowers/              ← Design docs\n```\n\n**Runtime state** (in your project, not the plugin):\n\n```\n<your-project>/\n├── .zac/\n│   └── sessions.json             ← Session ID → phase mapping + retry count\n└── .omc/logs/\n    └── stop-hook.log             ← Hook execution log\n```\n\n## Dependencies\n\nZAC leverages these Claude Code plugins:\n\n- **superpowers** — Skill orchestration and development workflows\n- **frontend-design** — Production-grade UI generation\n- **context7** — Up-to-date documentation lookup\n- **code-review** — Automated code review\n- **code-simplifier** — Code cleanup and simplification\n- **playwright** — Browser automation for testing\n- **feature-dev** — Guided feature development\n- **ralph-loop** — Iterative refinement loop\n- **typescript-lsp** / **pyright-lsp** — Language server intelligence\n- **commit-commands** — Git commit and PR workflows\n\n## Failure Handling\n\n| Scenario | Behavior |\n|----------|----------|\n| Session stops normally | Advance to next phase per state machine |\n| `StopFailure` fires | Retry current phase (retry_count + 1) |\n| Same phase fails 3 times | Stop workflow, log error, wait for human intervention |\n| Untracked session stops | Ignored — only tracked sessions drive transitions |\n\n## License\n\nMIT\n",
  "bytes": 5630,
  "sha": "45468d5be4e2d3cbd8dcd5fb6f6f03f824b10c43c7c0c91fe087e563d3257019",
  "repo_slug": "im-zhong/zac",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_im_zhong_zac_zac_feb511db/readme"
}