{"id":35173284,"url":"https://github.com/agentic15/claude-zen","last_synced_at":"2026-01-13T22:57:53.238Z","repository":{"id":330984683,"uuid":"1122455073","full_name":"agentic15/claude-zen","owner":"agentic15","description":"Structured AI-assisted development framework for Claude Code with enforced quality standards, automated testing, and production-ready workflows","archived":false,"fork":false,"pushed_at":"2026-01-06T17:38:29.000Z","size":1863,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T22:57:45.577Z","etag":null,"topics":["claude-code","process","project","testing"],"latest_commit_sha":null,"homepage":"htttps://www.agentic15.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agentic15.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-24T19:06:43.000Z","updated_at":"2026-01-06T17:38:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/agentic15/claude-zen","commit_stats":null,"previous_names":["agentic15/claude-zen"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/agentic15/claude-zen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic15%2Fclaude-zen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic15%2Fclaude-zen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic15%2Fclaude-zen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic15%2Fclaude-zen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agentic15","download_url":"https://codeload.github.com/agentic15/claude-zen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic15%2Fclaude-zen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28405141,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T21:51:37.118Z","status":"ssl_error","status_checked_at":"2026-01-13T21:45:14.585Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["claude-code","process","project","testing"],"created_at":"2025-12-28T21:37:42.211Z","updated_at":"2026-01-13T22:57:53.227Z","avatar_url":"https://github.com/agentic15.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Agentic15 Claude Zen\n\n**Structured AI-Assisted Development Framework for Claude Code**\n\n[![npm version](https://badge.fury.io/js/@agentic15.com%2Fagentic15-claude-zen.svg)](https://www.npmjs.com/package/@agentic15.com/agentic15-claude-zen)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\n---\n\n## Overview\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### What is Agentic15 Claude Zen?\n\nAgentic15 Claude Zen is a structured development framework designed to work seamlessly with Claude Code. It provides task tracking, workflow structure, and platform integration (GitHub or Azure DevOps) without enforcing rigid testing requirements.\n\n**Philosophy:** Structure, not enforcement. The framework provides commands and organization, while Claude decides when tests are appropriate.\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Key Benefits\n\n- ✅ **Task tracking** and organization\n- ✅ **Consistent workflow** structure\n- ✅ **Dual-platform support** - GitHub or Azure DevOps\n- ✅ **Automated PRs** and issue tracking\n- ✅ **UI verification** - Screenshots and accessibility testing\n- ✅ **Token-efficient** - Optimized for Claude Code\n- ✅ **Flexible** - No mandatory testing requirements\n- ✅ **Production-ready** - Service layer patterns built-in\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Quick Start\n\n### 1. Create Project\n\n**Bash/Mac/Linux:**\n```bash\nnpx @agentic15.com/agentic15-claude-zen my-project\ncd my-project\n```\n\n**Windows (PowerShell):**\n```powershell\nnpx @agentic15.com/agentic15-claude-zen my-project\ncd my-project\n```\n\n### 2. Setup Platform\n\n**GitHub:**\n```bash\nnpx agentic15 auth\n```\n\n**Azure DevOps:**\n```bash\naz login \u0026\u0026 az devops login\n```\n\n**📘 Detailed Setup Guides:**\n- [GitHub Setup Guide](./Agent/docs/GITHUB-SETUP.md)\n- [Azure DevOps Setup Guide](./Agent/docs/AZURE-SETUP.md)\n\n### 3. Create First Plan\n\n```bash\nnpx agentic15 plan \"Build a todo app with add, remove, and list features\"\n```\n\nIn Claude Code:\n```\nAsk: \"Create the project plan from the requirements file\"\n```\n\nThen lock the plan:\n```bash\nnpx agentic15 plan\n```\n\n### 4. Start First Task\n\n```bash\nnpx agentic15 task next\n```\n\n---\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `npx agentic15 plan [requirements]` | Generate or lock project plan |\n| `npx agentic15 plan archive [reason]` | Archive completed plan |\n| `npx agentic15 task next` | Start next pending task |\n| `npx agentic15 task start TASK-ID` | Start specific task |\n| `npx agentic15 status` | Show project status |\n| `npx agentic15 commit` | Commit \u0026 create PR |\n| `npx agentic15 sync` | Sync with main after PR merge |\n| `npx agentic15 visual-test \u003curl\u003e` | Capture UI screenshots and console errors |\n| `npx agentic15 auth` | Configure GitHub authentication |\n\n---\n\n## Daily Workflow\n\n### 1. Implement (Claude Code)\n```\nAsk: \"Implement the active task\"\n```\n\nClaude writes code in `Agent/` directory.\n\n### 2. Commit \u0026 PR (Your Terminal)\n```bash\nnpx agentic15 commit\n```\n\nStages changes, commits, pushes, creates PR.\n\n### 3. Review (GitHub/Azure)\nReview and merge the PR.\n\n### 4. Sync \u0026 Next (Your Terminal)\n```bash\nnpx agentic15 sync\nnpx agentic15 task next\n```\n\nSyncs with main, deletes feature branch, starts next task.\n\n---\n\n## Platform Integration\n\n**Choose one platform for your project:**\n\n### GitHub\n\n**Quick Setup:**\n```bash\nnpx agentic15 auth  # Authenticate with GitHub CLI\n```\n\n**📘 [Complete GitHub Setup Guide](./Agent/docs/GITHUB-SETUP.md)**\n\n---\n\n### Azure DevOps\n\n**Quick Setup:**\n```bash\naz login           # Authenticate with Azure\naz devops login    # Authenticate with Azure DevOps\n```\n\n**📘 [Complete Azure DevOps Setup Guide](./Agent/docs/AZURE-SETUP.md)**\n\n**Additional Resources:**\n- [Azure Integration Guide](./Agent/docs/azure-integration-guide.md)\n- [Azure Authentication](./Agent/docs/azure-authentication.md)\n- [Azure Quick Reference](./Agent/docs/azure-quick-reference.md)\n\n---\n\n### Platform Comparison\n\n| Feature | GitHub | Azure DevOps |\n|---------|--------|--------------|\n| **Authentication** | `gh` CLI (no tokens) | Azure CLI + PAT |\n| **Setup Command** | `npx agentic15 auth` | `az login \u0026\u0026 az devops login` |\n| **PR Creation** | `gh pr create` | `az repos pr create` |\n| **Issue Tracking** | GitHub Issues (optional) | Azure Boards (optional) |\n| **Auto-Detection** | From git remote | From git remote |\n\n---\n\n## Upgrading\n\n### Upgrade Framework\n\n```bash\nnpm install -g @agentic15.com/agentic15-claude-zen@latest\n```\n\n**What gets updated:**\n- ✅ Framework hooks in `node_modules`\n- ✅ Settings schema and templates\n- ✅ CLI commands\n\n**What stays unchanged:**\n- ✅ Your code in `Agent/`\n- ✅ Your plans and tasks in `.claude/plans/`\n- ✅ Your local settings in `.claude/settings.local.json`\n\n**After upgrading:**\n```bash\nnpx agentic15 update-settings\n```\n\nThis updates your `.claude/settings.json` with the latest framework configuration. Your existing settings will be backed up to `.claude/settings.json.backup`.\n\n---\n\n## Requirements \u0026 Philosophy\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Requirements\n\n- **Node.js:** 18.0.0 or higher\n- **Git:** Any recent version\n- **Platform CLI:** `gh` (GitHub) or `az` (Azure DevOps)\n- **Claude Code:** Latest version recommended\n\n### Documentation\n\n- **[CHANGELOG.md](./Agent/CHANGELOG.md)** - Version history and release notes\n- **[GitHub Setup](./Agent/docs/GITHUB-SETUP.md)** - Detailed GitHub integration\n- **[Azure Setup](./Agent/docs/AZURE-SETUP.md)** - Detailed Azure DevOps integration\n\n### Support\n\n- **Issues:** https://github.com/agentic15/claude-zen/issues\n- **Documentation:** https://github.com/agentic15/claude-zen\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Philosophy\n\nThis framework embodies a **lean** philosophy:\n\n**Structure, not enforcement:**\n- Provides organization and commands\n- No mandatory testing requirements\n- Claude decides what tests are appropriate\n\n**Token efficiency:**\n- Centralized service layer for data-driven apps\n- Optimized patterns reduce token usage\n- Production-ready code from the start\n\n**User engagement:**\n- UI-first development approach\n- Working demos from Day 1\n- Visual verification over unit testing\n\n**Workflow consistency:**\n- Plans and tasks follow same patterns\n- Branch → Commit → PR → Sync\n- Autonomous when possible, manual when needed\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## License\n\nApache 2.0 - See [LICENSE](./Agent/LICENSE) for details.\n\nCopyright 2024-2026 agentic15.com\n\n---\n\n**For version history and release notes, see [CHANGELOG.md](./Agent/CHANGELOG.md)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentic15%2Fclaude-zen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagentic15%2Fclaude-zen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentic15%2Fclaude-zen/lists"}