🤖 HeyClaudio - AI-Powered Development Assistant

Setup once, develop with AI everywhere.

HeyClaudio transforms any repository into an AI-powered development environment with R.A.D.A.R. analysis and C.I.D.E.R. atomic issues for Claude IDE.

🚀 Quick Start

# 1. Install globally
npm i -g hey-claudio

# 2. Setup in any project
cd your-project
claudio init

# 3. Start developing with AI
claude
# Then use: /radar:analyze, /cider:generate, /cider:work

✨ What You Get

🎯 Smart Project Setup

• One command setup: claudio init configures everything
• Smart detection: Automatically detects your tech stack
• Claude IDE integration: Native slash commands ready to use

🔍 R.A.D.A.R. Analysis

• Reconocimiento: Codebase structure and architecture
• Análisis: Code quality, patterns, dependencies
• Documentación: Missing docs, outdated content
• Arquitectura: Design decisions and improvements
• Recomendaciones: Actionable improvement suggestions

🎯 C.I.D.E.R. Atomic Issues

• Contextualizar: Understand current project state
• Iterar: Plan approach and break into tasks
• Documentar: Create specifications and requirements
• Ejecutar: Define implementation steps
• Reflexionar: Plan testing and validation

📋 Usage

Setup (One Time)

npm i -g hey-claudio
cd your-project
claudio init                 # Creates .claude/ structure + slash commands

Daily Development

claudio status              # Check project status
claude                      # Open Claude IDE

# Inside Claude IDE:
/radar:analyze              # Complete project analysis
/radar:quick               # Quick project overview
/cider:generate EPIC-API "implement auth"  # Generate atomic issues
/cider:work 123            # Work on specific issue
/cider:status              # Project status overview
/cider:list-epics          # Show available epics

Quick Commands

claudio                    # Show status + next steps
claudio open              # Open Claude IDE
claudio analyze           # Quick analysis without Claude IDE
claudio check             # Verify configuration

🏗️ Project Structure Created

your-project/
├── .claude/
│   ├── commands/          # Native slash commands
│   │   ├── radar/         # Analysis commands
│   │   └── cider/         # Issue management commands
│   ├── current/           # Active project state
│   │   ├── project-state.md
│   │   ├── active-epic.md
│   │   └── next-session.md
│   ├── epics/             # Epic management
│   │   └── epics-roadmap.md
│   ├── sessions/          # Session history
│   ├── guides/            # Development methodology
│   └── templates/         # Reusable templates
└── analysis/              # Generated analysis reports

🎯 Workflow

1. Project Initialization

claudio init
# ✅ Creates .claude/ structure
# ✅ Detects tech stack
# ✅ Creates suggested epics
# ✅ Sets up development methodology

2. Analysis & Understanding

claude                     # Open Claude IDE
/radar:analyze            # Complete analysis
# ✅ Architecture analysis
# ✅ Code quality assessment
# ✅ Improvement recommendations
# ✅ Epic suggestions

3. Issue Generation

/cider:generate EPIC-FRONTEND "implement responsive design"
# ✅ Creates atomic issue (2-6 hours)
# ✅ Defines acceptance criteria
# ✅ Plans implementation approach
# ✅ Sets up C.I.D.E.R. workflow

4. Development Execution

/cider:work 123
# ✅ Loads issue context
# ✅ Plans work approach
# ✅ Tracks progress
# ✅ Updates project state

🔧 Available Slash Commands

| Command | Description | |---------|-------------| | /radar:analyze | Complete project analysis with recommendations | | /radar:quick | Quick project overview and status | | /cider:generate EPIC "desc" | Generate atomic development issue | | /cider:work ISSUE_NUMBER | Work on specific issue with guidance | | /cider:status | Show project and epic status | | /cider:list-epics | List all available epics | | /init:claude | Generate CLAUDE.md with complete methodology |

🎨 Example Epic Types

HeyClaudio automatically suggests epics based on your tech stack:

• EPIC-FRONTEND: User interface development
• EPIC-BACKEND: Server-side development
• EPIC-DATABASE: Data management
• EPIC-API: API development
• EPIC-TESTING: Quality assurance
• EPIC-DEPLOYMENT: DevOps & infrastructure
• EPIC-PERFORMANCE: Optimization
• EPIC-SECURITY: Security implementation
• EPIC-DOCS: Documentation

🔍 Example Analysis Output

/radar:analyze

Generates comprehensive reports:

• Executive Summary: Key findings and priorities
• Architecture Analysis: Structure and design patterns
• Code Quality: Issues and improvements
• Dependency Analysis: Package management and updates
• Documentation Review: Missing or outdated docs
• Security Assessment: Potential vulnerabilities
• Performance Analysis: Optimization opportunities

🎯 Atomic Issue Example

/cider:generate EPIC-API "implement user authentication"

Creates issue with:

• ✅ Clear objectives and acceptance criteria
• ✅ Task breakdown (2-6 hour target)
• ✅ Implementation approach and technical requirements
• ✅ Testing strategy and validation steps
• ✅ Files to modify and integration points
• ✅ C.I.D.E.R. workflow tracking

🚀 Benefits

For Individual Developers

• ✅ Instant project understanding with R.A.D.A.R. analysis
• ✅ Structured development with C.I.D.E.R. methodology
• ✅ Clear work breakdown into atomic issues
• ✅ Progress tracking and session management

For Teams

• ✅ Consistent methodology across projects
• ✅ Knowledge sharing through documentation
• ✅ Quality standards with built-in best practices
• ✅ Project visibility with status tracking

For Freelancers/Consultants

• ✅ Quick client onboarding with instant analysis
• ✅ Professional reporting with detailed insights
• ✅ Structured proposals based on epic breakdown
• ✅ Progress transparency for clients

🛠️ Requirements

• Node.js 14+
• Claude IDE (Download here)
• Git (recommended)

📦 Installation

Global Installation (Recommended)

npm i -g hey-claudio

Local Installation

cd your-project
npm i hey-claudio
npx hey-claudio init

🆘 Support

Having issues? Check common solutions:

"claude command not found"

Install Claude IDE: https://claude.ai/download

"Project not setup"

claudio init

"No slash commands available"

claudio check          # Verify setup
claudio init           # Re-initialize if needed

Debug Mode

CLAUDIO_DEBUG=true claudio init

🎯 Perfect For

• ✅ New project onboarding - Understand any codebase instantly
• ✅ Legacy code analysis - Get insights into old projects
• ✅ Freelance work - Professional analysis and structured development
• ✅ Team collaboration - Consistent methodology and documentation
• ✅ Code reviews - Structured analysis and improvement suggestions
• ✅ Technical debt - Identify and plan improvements systematically

🤝 Contributing

This project is designed to work seamlessly with Claude IDE and AI-powered development workflows.

📄 License

MIT - Build amazing things with AI assistance!

🤖 HeyClaudio - Making every developer an AI-powered expert