https://github.com/agentic15/claude-zen
Structured AI-assisted development framework for Claude Code with enforced quality standards, automated testing, and production-ready workflows
https://github.com/agentic15/claude-zen
claude-code process project testing
Last synced: about 1 month ago
JSON representation
Structured AI-assisted development framework for Claude Code with enforced quality standards, automated testing, and production-ready workflows
- Host: GitHub
- URL: https://github.com/agentic15/claude-zen
- Owner: agentic15
- License: apache-2.0
- Created: 2025-12-24T19:06:43.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-01-06T17:38:29.000Z (about 1 month ago)
- Last Synced: 2026-01-13T22:57:45.577Z (about 1 month ago)
- Topics: claude-code, process, project, testing
- Language: JavaScript
- Homepage: htttps://www.agentic15.com
- Size: 1.78 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Notice: NOTICE
Awesome Lists containing this project
README
# Agentic15 Claude Zen
**Structured AI-Assisted Development Framework for Claude Code**
[](https://www.npmjs.com/package/@agentic15.com/agentic15-claude-zen)
[](https://opensource.org/licenses/Apache-2.0)
---
## Overview
### What is Agentic15 Claude Zen?
Agentic15 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.
**Philosophy:** Structure, not enforcement. The framework provides commands and organization, while Claude decides when tests are appropriate.
### Key Benefits
- ✅ **Task tracking** and organization
- ✅ **Consistent workflow** structure
- ✅ **Dual-platform support** - GitHub or Azure DevOps
- ✅ **Automated PRs** and issue tracking
- ✅ **UI verification** - Screenshots and accessibility testing
- ✅ **Token-efficient** - Optimized for Claude Code
- ✅ **Flexible** - No mandatory testing requirements
- ✅ **Production-ready** - Service layer patterns built-in
---
## Quick Start
### 1. Create Project
**Bash/Mac/Linux:**
```bash
npx @agentic15.com/agentic15-claude-zen my-project
cd my-project
```
**Windows (PowerShell):**
```powershell
npx @agentic15.com/agentic15-claude-zen my-project
cd my-project
```
### 2. Setup Platform
**GitHub:**
```bash
npx agentic15 auth
```
**Azure DevOps:**
```bash
az login && az devops login
```
**📘 Detailed Setup Guides:**
- [GitHub Setup Guide](./Agent/docs/GITHUB-SETUP.md)
- [Azure DevOps Setup Guide](./Agent/docs/AZURE-SETUP.md)
### 3. Create First Plan
```bash
npx agentic15 plan "Build a todo app with add, remove, and list features"
```
In Claude Code:
```
Ask: "Create the project plan from the requirements file"
```
Then lock the plan:
```bash
npx agentic15 plan
```
### 4. Start First Task
```bash
npx agentic15 task next
```
---
## Commands
| Command | Description |
|---------|-------------|
| `npx agentic15 plan [requirements]` | Generate or lock project plan |
| `npx agentic15 plan archive [reason]` | Archive completed plan |
| `npx agentic15 task next` | Start next pending task |
| `npx agentic15 task start TASK-ID` | Start specific task |
| `npx agentic15 status` | Show project status |
| `npx agentic15 commit` | Commit & create PR |
| `npx agentic15 sync` | Sync with main after PR merge |
| `npx agentic15 visual-test ` | Capture UI screenshots and console errors |
| `npx agentic15 auth` | Configure GitHub authentication |
---
## Daily Workflow
### 1. Implement (Claude Code)
```
Ask: "Implement the active task"
```
Claude writes code in `Agent/` directory.
### 2. Commit & PR (Your Terminal)
```bash
npx agentic15 commit
```
Stages changes, commits, pushes, creates PR.
### 3. Review (GitHub/Azure)
Review and merge the PR.
### 4. Sync & Next (Your Terminal)
```bash
npx agentic15 sync
npx agentic15 task next
```
Syncs with main, deletes feature branch, starts next task.
---
## Platform Integration
**Choose one platform for your project:**
### GitHub
**Quick Setup:**
```bash
npx agentic15 auth # Authenticate with GitHub CLI
```
**📘 [Complete GitHub Setup Guide](./Agent/docs/GITHUB-SETUP.md)**
---
### Azure DevOps
**Quick Setup:**
```bash
az login # Authenticate with Azure
az devops login # Authenticate with Azure DevOps
```
**📘 [Complete Azure DevOps Setup Guide](./Agent/docs/AZURE-SETUP.md)**
**Additional Resources:**
- [Azure Integration Guide](./Agent/docs/azure-integration-guide.md)
- [Azure Authentication](./Agent/docs/azure-authentication.md)
- [Azure Quick Reference](./Agent/docs/azure-quick-reference.md)
---
### Platform Comparison
| Feature | GitHub | Azure DevOps |
|---------|--------|--------------|
| **Authentication** | `gh` CLI (no tokens) | Azure CLI + PAT |
| **Setup Command** | `npx agentic15 auth` | `az login && az devops login` |
| **PR Creation** | `gh pr create` | `az repos pr create` |
| **Issue Tracking** | GitHub Issues (optional) | Azure Boards (optional) |
| **Auto-Detection** | From git remote | From git remote |
---
## Upgrading
### Upgrade Framework
```bash
npm install -g @agentic15.com/agentic15-claude-zen@latest
```
**What gets updated:**
- ✅ Framework hooks in `node_modules`
- ✅ Settings schema and templates
- ✅ CLI commands
**What stays unchanged:**
- ✅ Your code in `Agent/`
- ✅ Your plans and tasks in `.claude/plans/`
- ✅ Your local settings in `.claude/settings.local.json`
**After upgrading:**
```bash
npx agentic15 update-settings
```
This updates your `.claude/settings.json` with the latest framework configuration. Your existing settings will be backed up to `.claude/settings.json.backup`.
---
## Requirements & Philosophy
### Requirements
- **Node.js:** 18.0.0 or higher
- **Git:** Any recent version
- **Platform CLI:** `gh` (GitHub) or `az` (Azure DevOps)
- **Claude Code:** Latest version recommended
### Documentation
- **[CHANGELOG.md](./Agent/CHANGELOG.md)** - Version history and release notes
- **[GitHub Setup](./Agent/docs/GITHUB-SETUP.md)** - Detailed GitHub integration
- **[Azure Setup](./Agent/docs/AZURE-SETUP.md)** - Detailed Azure DevOps integration
### Support
- **Issues:** https://github.com/agentic15/claude-zen/issues
- **Documentation:** https://github.com/agentic15/claude-zen
### Philosophy
This framework embodies a **lean** philosophy:
**Structure, not enforcement:**
- Provides organization and commands
- No mandatory testing requirements
- Claude decides what tests are appropriate
**Token efficiency:**
- Centralized service layer for data-driven apps
- Optimized patterns reduce token usage
- Production-ready code from the start
**User engagement:**
- UI-first development approach
- Working demos from Day 1
- Visual verification over unit testing
**Workflow consistency:**
- Plans and tasks follow same patterns
- Branch → Commit → PR → Sync
- Autonomous when possible, manual when needed
---
## License
Apache 2.0 - See [LICENSE](./Agent/LICENSE) for details.
Copyright 2024-2026 agentic15.com
---
**For version history and release notes, see [CHANGELOG.md](./Agent/CHANGELOG.md)**