This repository provides an AI-driven development workflow system, "Spec Workflow System," built on Claude Code's Sub-Agents. It aims to automate the software development lifecycle from project idea to production-ready code by orchestrating specialized AI agents through distinct phases, offering faster development and consistent quality.

How It Works

The system integrates Claude Code's Sub-Agents, leveraging their isolated context windows for focused, specialized tasks. The workflow is divided into three main phases: Planning (requirements analysis, architecture design, task breakdown), Development (implementation, testing), and Validation (code review, final checks). Each phase includes automated quality gates that validate the completeness and quality of artifacts, with mechanisms to loop back for revisions if gates fail. Agents communicate via structured artifacts, with the orchestrator managing the overall flow.

Quick Start & Requirements

• Installation: Clone the repository (git clone https://github.com/zhsama/claude-sub-agent.git) and copy agents and slash commands to your project's .claude directory.
• Prerequisites: Claude Code (latest version), project directory initialized, basic understanding of AI-assisted development.
• Usage: Initiate workflows via Claude prompts (e.g., "Use the spec-orchestrator agent to create a todo list web application") or slash commands (e.g., /agent-workflow "Create a task management web application").
• Documentation: See commands/agent-workflow.md for detailed slash command options.

Highlighted Details

• Phased Workflow: Structured into Planning, Development, and Validation phases with distinct agent roles.
• Quality Gates: Automated checkpoints (Gate 1: Planning, Gate 2: Development, Gate 3: Production Readiness) with configurable thresholds (75-95%).
• Specialized Agents: Includes core workflow agents (spec-agents/) and domain-specific agents for backend, frontend, and UI/UX.
• Customizable Commands: Slash commands support options for quality thresholds, skipping agents, specifying phases, output directories, and documentation language.

Maintenance & Community

• Contributions are welcomed via pull requests.
• The project is built on Claude Code's Sub-Agents feature and inspired by the BMAD methodology.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive MIT license allows for commercial use and integration with closed-source projects.

Limitations & Caveats

The system relies on the Claude Code platform and its Sub-Agents feature; functionality is dependent on Claude Code's stability and capabilities. Quality gate failures may require manual intervention or iterative agent revisions.