claudio

Claudio

A project analysis and planning system that transforms any codebase into an organized, trackable development process through specialized AI agents and project localization.

What is Claudio?

Claudio orchestrates discovery, requirements, planning, and task organization through 77+ specialized AI agents with standardized coordination patterns that work together to analyze, plan, and implement project solutions. The system uses a mature agent-based architecture with universal argument extraction where components are intelligently customized for each project based on comprehensive discovery analysis of technology stack, architecture patterns, and project requirements.

The system transforms ad-hoc development into systematic, trackable, and collaborative project execution through intelligent project localization, anti-fabrication policies, and comprehensive workflow automation.

Requirements

• Claude Code CLI: This system is designed for use with Claude Code
• The Claude Code CLI provides the runtime environment and tools that Claudio agents use
• No additional installations required - Claudio works within your existing Claude Code setup

Documentation

Core Documentation

• Usage Guide - Complete command reference, workflow examples, and practical usage patterns
• System Architecture - Extended context structure, agent integration, and technical implementation details
• Specialized Features - Research system, Claude SDK capabilities, and advanced features
• Best Practices - Development workflows, context management, and integration guidance
• Changelog Management - Maintenance protocol and update procedures

Table of Contents: What is Claudio? | Documentation | Requirements | Quick Start | Key Features | Commands | Installation | Project Structure | Document Types | Advanced Features | Development | Troubleshooting

Quick Start

Note: Where you start your Claude session determines automatic project memory loading from CLAUDE.md files. We take advantage of this behavior until Claude supports alternative methods for project context loading.

Setup Phase

# 1. Clone Claudio
git clone <this-repo>
cd claudio

# 2. Start Claude with directory access to your project  
claude --add-dir /path/to/my-code

# 3. Run Claudio system command
/claudio:claudio /path/to/my-code
# Optional: Use install-only command instead
/claudio:install /path/to/my-code

# 4. Exit Claude session
exit

Usage Phase

# 1. Navigate to your project
cd /path/to/my-code

# 2. Start Claude session (loads project CLAUDE.md automatically)
claude

# 3. Use project commands
# Optional: Create additional plans
/claudio:plan feature "my new feature, add to project phases"
/claudio:implement  # Follows plans created by claudio workflow or install
/claudio:test
# Natural language: "use the claudio workflow to add my new feature to the phased planning documents"

Upgrade Phase

# 1. Update Claudio (choose one method)
# From your project directory:
git submodule update --remote
# OR from the claudio directory:
cd claudio && git pull

# 2. Navigate to Claudio directory
cd claudio
# Note: Use `pwd` to verify your current directory

# 3. Start Claude with directory access to your project
claude --add-dir /path/to/my-code

# 4. Run Claudio upgrade command
/claudio:upgrade /path/to/my-code

# 5. Exit Claude session
exit

Key Features

Agent Coordination System

• Universal Argument Extraction: All 77+ agents implement standardized argument extraction logic for consistent project path handling and cross-agent communication
• Anti-Fabrication Standards: System-wide policies ensure outputs are based on actual project analysis with factual, measurable results
• Template System: Comprehensive template library in extended_context/templates/ provides consistent patterns for agent and command development
• Project Path Isolation: Robust path handling prevents system contamination during multi-project workflows