Agentic15 Claude Zen

Structured AI-Assisted Development Framework for Claude Code

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:

npx @agentic15.com/agentic15-claude-zen my-project
cd my-project

Windows (PowerShell):

npx @agentic15.com/agentic15-claude-zen my-project
cd my-project

2. Setup Platform

GitHub:

npx agentic15 auth

Azure DevOps:

az login && az devops login

📘 Detailed Setup Guides:

• GitHub Setup Guide
• Azure DevOps Setup Guide

3. Create First Plan

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:

npx agentic15 plan

4. Start First Task

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 <url> | 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)

npx agentic15 commit

Stages changes, commits, pushes, creates PR.

3. Review (GitHub/Azure)

Review and merge the PR.

4. Sync & Next (Your Terminal)

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:

npx agentic15 auth  # Authenticate with GitHub CLI

📘 Complete GitHub Setup Guide

Azure DevOps

Quick Setup:

az login           # Authenticate with Azure
az devops login    # Authenticate with Azure DevOps

📘 Complete Azure DevOps Setup Guide

Additional Resources:

• Azure Integration Guide
• Azure Authentication
• Azure Quick Reference

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

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:

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 - Version history and release notes
• GitHub Setup - Detailed GitHub integration
• Azure Setup - 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 for details.

Copyright 2024-2026 agentic15.com

For version history and release notes, see CHANGELOG.md