Adaptive Claude Agents

Claude Code Extension Framework - Two innovative features not available in official Claude Code

🔴 Phase-Adaptive Review - Automatically adjusts review standards based on development phase (Industry First) 🔵 Tech Stack Auto-Detection - Analyzes projects and auto-generates subagents

日本語版 README | Documentation

---

🎯 Why This Project?

What Claude Code's official features (.claude/agents/, .claude/skills/) can do:

• ✅ Project-specific configuration files
• ✅ Subagent definitions
• ✅ Skill definitions

What official features cannot do (this project provides):

Feature	Official Claude Code	This Project
Phase-Adaptive Review	❌ Fixed standards only	✅ Auto-detect Prototype→MVP→Production
Tech Stack Auto-Detection	❌ Manual setup only	✅ Analyze package.json etc. automatically
Subagent Auto-Generation	❌ Manual creation only	✅ Generate from detection results

---

🔴 Core Feature 1: Phase-Adaptive Review (Industry First)

Automatically adjusts review standards based on development phase:

Phase	Rigor	Focus	Example Feedback
Prototype	3/10	"Does it work?"	"This works! Consider adding error handling later."
MVP	6/10	"Is it secure?"	"Add input validation to prevent SQL injection."
Production	10/10	"Is it perfect?"	"Needs comprehensive error handling, tests, and monitoring."

Auto Phase Detection (7 Signals)

$ python3 skills/adaptive-review/detect_phase.py .

Phase: MVP
Confidence: 72%

Detection Signals:
  • Version 0.5.0 → MVP
  • 127 commits → MVP stage
  • 45 test files → basic testing (56%)
  • CI/CD: GitHub Actions ✓

No other AI coding tool (GitHub Copilot, Cursor, etc.) has this.

---

🔵 Core Feature 2: Tech Stack Auto-Detection

Analyzes your project and auto-generates appropriate subagents:

$ python3 skills/project-analyzer/analyze_project.py .

━━━━━━━━━━━━━━━━━━━━━━━━━
Detection Results
━━━━━━━━━━━━━━━━━━━━━━━━━
Framework: FastAPI 0.115.0
Language:  Python 3.11
Database:  PostgreSQL
Confidence: 95%
━━━━━━━━━━━━━━━━━━━━━━━━━

Subagents to generate:
  • api-developer
  • api-tester
  • sqlalchemy-specialist

Continue? [Y/n]

Supported Frameworks (11)

Next.js, React, Vue, FastAPI, Django, Flask, Go, Flutter, iOS Swift, Vanilla Web (PHP/JS/HTML), Python ML/CV

---

🚀 Quick Start

Installation

curl -fsSL https://raw.githubusercontent.com/SawanoLab/adaptive-claude-agents/main/install.sh | bash

Usage

# Run in your project directory
cd /path/to/your/project

# Tech stack detection + subagent generation
python3 "$HOME/Library/Application Support/Claude/skills/adaptive-claude-agents/skills/project-analyzer/analyze_project.py" .

# Phase detection
python3 "$HOME/Library/Application Support/Claude/skills/adaptive-claude-agents/skills/adaptive-review/detect_phase.py" .

Or ask Claude Code directly:

> "Analyze my project and generate subagents"
> "Detect development phase and adjust review standards"

---

📊 Relationship with Official Features

┌─────────────────────────────────────────────────────────┐
│  Claude Code Official Features (Foundation)             │
│ ├─ .claude/settings.json   Configuration               │
│ ├─ .claude/agents/         Subagent definitions        │
│ ├─ .claude/skills/         Skill definitions           │
│ └─ CLAUDE.md               Project memory              │
└─────────────────────────────────────────────────────────┘
                    ↓ Extension
┌─────────────────────────────────────────────────────────┐
│  Adaptive Claude Agents (This Project)                  │
│ ├─ 🔴 Phase-Adaptive Review  ← Not in official         │
│ │     └─ skills/adaptive-review/                        │
│ ├─ 🔵 Tech Stack Detection   ← Not in official         │
│ │     └─ skills/project-analyzer/                       │
│ └─ 📦 Subagent Template Collection                      │
│       └─ templates/                                     │
└─────────────────────────────────────────────────────────┘

---

📦 Template Collection

Templates can also be manually placed in .claude/agents/. This project provides auto-detection and auto-generation.

Available Templates

Category	Templates
FastAPI	api-developer, api-tester, sqlalchemy-specialist
Next.js	nextjs-tester
Go	go-developer
Flutter	flutter-developer
iOS Swift	swift-developer
Python ML/CV	python-ml-developer, cv-specialist
Vanilla Web (PHP/JS/HTML)	php-developer, vanilla-js-developer, mysql-specialist, playwright-tester
Common	chrome-devtools-tester

Common Skills (New!)

Universal development skills applicable to any project. Based on claude-code-templates.

Skill	Description	Recommended Phase
test-driven-development	TDD practice guide	Production (required)
systematic-debugging	Systematic debugging methodology	All phases
verification-before-completion	Pre-completion verification	MVP/Production
git-commit-helper	Commit message creation	All phases
writing-plans	Implementation planning	MVP/Production

Template Variables

{{VARIABLE}} in templates are auto-substituted during project analysis:

Variable	Description	Example
{{LANGUAGE}}	Programming language	Python 3.11, TypeScript 5.x
{{FRAMEWORK}}	Framework	FastAPI, Next.js 15, Gin
{{DATABASE}}	Database	PostgreSQL, MySQL, MongoDB
{{VERSION}}	Version	0.115.0, 15.0.0

---

🛠️ Project Structure

adaptive-claude-agents/
├── skills/
│   ├── project-analyzer/     # 🔵 Tech stack auto-detection
│   │   ├── analyze_project.py
│   │   └── detect_stack.py
│   ├── adaptive-review/      # 🔴 Phase-adaptive review
│   │   └── detect_phase.py
│   └── common/               # 🟢 Common development skills
│       ├── test-driven-development.md
│       ├── systematic-debugging.md
│       ├── verification-before-completion.md
│       ├── git-commit-helper.md
│       └── writing-plans.md
├── templates/                 # 📦 Subagent templates
└── install.sh

---

🤝 Contributing

• Bug Report
• Feature Request

---

📄 License

MIT License - LICENSE

---

Made with ❤️ by SawanoLab (Aichi Institute of Technology)

⭐ Star us on GitHub if you find this useful!