Skip to content

HanTechnology/dev-ai-agent-team-boilerplate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

45 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Development AI Agent Team Boilerplate

๐Ÿš€ Next-Generation LLM CLI Runtime Development System Orchestrate specialized AI experts with automated project detection, intelligent collaboration, and zero-configuration deployment

Welcome to the Development AI Agent Team Boilerplate, an advanced project orchestration system designed for modern LLM CLI runtimes including Claude Code, Gemini CLI, Codex, and Junie. This repository provides a complete AI-powered development ecosystem with intelligent project detection, expert team assembly, and comprehensive quality managementโ€”all optimized for seamless LLM execution.

๐ŸŒŸ What Makes This Special?

This isn't just another boilerplateโ€”it's a complete AI development orchestration platform that transforms how LLM CLI runtimes handle complex development projects. Built with extensive integration testing and real-world optimization, it delivers enterprise-grade development workflows through simple user interactions.

โšก Revolutionary Features

  • ๐ŸŽฏ Intelligent Project Detection: Advanced keyword scoring algorithm automatically identifies project types and assembles optimal expert teams
  • ๐Ÿง  Integrated Memory System: Project-specific memory templates with real-time state preservation and context continuity across sessions
  • ๐Ÿ† Quality-First Architecture: Automated quality gates with validation commands, performance targets, and continuous improvement tracking
  • ๐Ÿค Dynamic Expert Collaboration: Signal-based coordination system enabling seamless cross-expert consultation and task handoffs
  • ๐Ÿ”„ Session Continuity: Advanced auto-compact handling with complete project state restoration
  • โš™๏ธ Zero Configuration: Intelligent defaults with automatic system setupโ€”just describe your project and start building

๐Ÿ—๏ธ Core Architecture Components

Component Description Integration Level
๐ŸŽฏ project-detection.yaml Advanced project type detection with keyword scoring (40pts keywords + 35pts frameworks + 25pts technologies) โšก Auto-Detection
๐Ÿ‘ฅ team.yaml 9 specialized experts with 45+ granular capabilities and cross-domain collaboration matrix ๐Ÿค Expert System
๐Ÿง  memory-templates.yaml Project-specific memory structures (.memory/ folder) with automatic context preservation ๐Ÿ’พ Memory System
๐Ÿ† quality-standards.json Comprehensive quality frameworks with validation commands and automated measurement โœ… Quality Gates
๐Ÿ”„ orchestration.yaml Complete development lifecycle with phased execution protocols and expert coordination ๐ŸŽผ Workflow Engine
๐Ÿ“‹ user_req.yaml Intelligent requirements capture with project constraint normalization ๐Ÿ“ Requirements
๐Ÿค– prompts/ 9 expert prompt files with auto-loading validation and collaboration protocols ๐Ÿš€ Expert Activation
๐Ÿ’พ .memory/ Real-time project state management with session continuity and decision tracking ๐Ÿ”„ State Management

๐Ÿš€ LLM CLI Runtime Support

LLM Runtime Main Guidelines Optimization Focus Key Capabilities
๐ŸŸฆ Claude Code CLAUDE.md Advanced reasoning & memory integration Auto-compact handling, session continuity, expert collaboration
๐ŸŸข Codex AGENTS.md Systematic analysis patterns Dual PM system, enhanced coordination protocols
๐ŸŸก Gemini CLI GEMINI.md Creative multimodal problem-solving Innovative approaches, visual integration, dynamic adaptation
๐ŸŸฃ Junie guidelines.md Ultra-efficient token optimization JetBrains integration, ~20k token limit optimization

๐ŸŽฏ Expert Domain Specializations

Expert Domain Core Expertise Technology Focus Integration Points
๐ŸŽจ Frontend Next.js architecture, component systems, UX optimization React, TypeScript, Tailwind CSS UI/API integration, performance optimization
โš™๏ธ Backend API design, database optimization, microservices Nest.js, Python, authentication, scaling Data architecture, security implementation
๐Ÿ”ง System Dev AI/ML systems, video processing, GPU computing TensorFlow, OpenCV, streaming, 3D conversion High-performance computing, real-time systems
๐ŸŒ Full Stack System architecture, cross-platform integration End-to-end coordination, technology unification Architecture decisions, integration orchestration
๐Ÿš€ DevOps Containerization, CI/CD, cloud deployment Docker, automation, infrastructure as code Deployment pipelines, monitoring, scaling
โœ… QA Automated testing, performance validation Playwright MCP, accessibility, security testing Quality gates, compliance verification
๐Ÿ” Research Market analysis, technology evaluation Strategic insights, competitive analysis Technology recommendations, risk assessment
๐Ÿ› ๏ธ MCP Tools Tool orchestration, workflow automation GitHub integration, Context7, Sequential Thinking Advanced tool combinations, performance optimization

๐Ÿ“ Complete System Architecture

dev-ai-agent-team-boilerplate/
โ”œโ”€โ”€ ๐ŸŽฏ Core Configuration
โ”‚   โ”œโ”€โ”€ project-detection.yaml      # Auto project type detection & expert assembly
โ”‚   โ”œโ”€โ”€ team.yaml                   # Expert definitions & collaboration matrix
โ”‚   โ”œโ”€โ”€ memory-templates.yaml       # Project-specific memory structures
โ”‚   โ”œโ”€โ”€ quality-standards.json      # Quality gates & validation frameworks
โ”‚   โ”œโ”€โ”€ orchestration.yaml          # Development lifecycle & task workflows
โ”‚   โ””โ”€โ”€ user_req.yaml              # Requirements capture template
โ”œโ”€โ”€ ๐Ÿš€ LLM Runtime Guidelines
โ”‚   โ”œโ”€โ”€ CLAUDE.md                   # Claude Code optimized guidelines
โ”‚   โ”œโ”€โ”€ AGENTS.md                   # Codex systematic analysis patterns
โ”‚   โ”œโ”€โ”€ GEMINI.md                   # Gemini multimodal capabilities
โ”‚   โ””โ”€โ”€ guidelines.md               # Junie token optimization
โ”œโ”€โ”€ ๐Ÿค– Expert Activation System
โ”‚   โ””โ”€โ”€ prompts/
โ”‚       โ”œโ”€โ”€ pm.prompt.md            # Project management & coordination
โ”‚       โ”œโ”€โ”€ frontend.prompt.md      # Next.js & UI development
โ”‚       โ”œโ”€โ”€ backend.prompt.md       # API & database architecture
โ”‚       โ”œโ”€โ”€ fullstack.prompt.md     # System integration & architecture
โ”‚       โ”œโ”€โ”€ system-dev.prompt.md    # AI/ML & high-performance systems
โ”‚       โ”œโ”€โ”€ devops.prompt.md        # Deployment & infrastructure
โ”‚       โ”œโ”€โ”€ qa-testing.prompt.md    # Quality assurance & testing
โ”‚       โ”œโ”€โ”€ research.prompt.md      # Market analysis & tech research
โ”‚       โ””โ”€โ”€ mcp-tools.prompt.md     # Tool orchestration & automation
โ”œโ”€โ”€ ๐Ÿ’พ Memory Management System
โ”‚   โ””โ”€โ”€ .memory/
โ”‚       โ”œโ”€โ”€ active-context.md       # Real-time project status
โ”‚       โ”œโ”€โ”€ decisions.md            # Technical decision history
โ”‚       โ”œโ”€โ”€ collaboration.log.md    # Expert interaction tracking
โ”‚       โ”œโ”€โ”€ project-state.json      # Comprehensive project metrics
โ”‚       โ”œโ”€โ”€ session-history.json    # Session continuity data
โ”‚       โ””โ”€โ”€ artifacts.manifest.json # Generated deliverables catalog
โ”œโ”€โ”€ ๐Ÿ› ๏ธ Environment Configurations
โ”‚   โ”œโ”€โ”€ .claude/settings.json       # Claude auto-compact hooks
โ”‚   โ”œโ”€โ”€ .junie/                     # Junie-specific optimization files
โ”‚   โ””โ”€โ”€ .mcp/                       # MCP server configurations
โ””โ”€โ”€ ๐Ÿ“š Domain Expertise Guides
    โ”œโ”€โ”€ frontend.md                 # Next.js & React best practices
    โ”œโ”€โ”€ backend.md                  # API & database architecture
    โ”œโ”€โ”€ system-dev.md               # AI/ML & system development
    โ”œโ”€โ”€ fullstack.md                # Integration & architecture
    โ”œโ”€โ”€ deployment.md               # DevOps & containerization
    โ”œโ”€โ”€ qa-testing.md               # Testing & quality assurance
    โ”œโ”€โ”€ mcp-tools.md                # Tool orchestration guide
    โ”œโ”€โ”€ project-management.md       # PM protocols & coordination
    โ””โ”€โ”€ research.md                 # Strategic analysis methods

๐Ÿš€ Getting Started - Experience Next-Level AI Development

๐ŸŽฏ Simple Project Creation

Before (Traditional approach):

"Create a web app with React, set up backend with Node.js, configure database, set up testing..."

Now (AI Agent Team approach):

"Create a todo management web app"
โ†’ Auto-detects: Web Application Project
โ†’ Assembles: Frontend + Backend + Full Stack + QA + DevOps experts
โ†’ Starts: Complete development workflow automatically

๐Ÿ“ฆ Installation Options

Choose your preferred LLM CLI runtime and get started instantly:

LLM Runtime Installation Command Auto-Setup Features
๐ŸŸฆ Claude Code ./install-claude.sh Auto-compact hooks, session continuity, memory integration
๐ŸŸข Codex ./install-codex.sh MCP configurations, systematic analysis setup
๐ŸŸก Gemini CLI ./install-gemini.sh Multimodal configurations, creative problem-solving setup
๐ŸŸฃ Junie ./install-junie.sh Token optimization, JetBrains integration

โšก One-Command Installation

Universal Installation (Recommended)

# Clone and auto-setup
git clone https://github.com/HanTechnology/dev-ai-agent-team-boilerplate.git
cd dev-ai-agent-team-boilerplate

# Windows
install.bat

# Linux/macOS
chmod +x install.sh && ./install.sh

Direct LLM-Specific Installation

# For Claude Code (Recommended for advanced features)
./install-claude.sh

# For Codex (Systematic analysis focus)
./install-codex.sh

# For Gemini CLI (Creative multimodal approach)
./install-gemini.sh

# For Junie (Token-optimized for JetBrains)
./install-junie.sh

๐ŸŽฏ How It Works - Revolutionary AI Development

๐Ÿš€ Intelligent Project Detection

Our advanced keyword scoring algorithm automatically identifies your project type:

Project Detection Algorithm:
- Keywords (40 points): "web app", "dashboard", "API", "mobile", "AI model"
- Frameworks (35 points): "React", "Next.js", "TensorFlow", "Flutter"
- Technologies (25 points): "TypeScript", "Python", "Docker", "GraphQL"

Example: "Create a React dashboard with Node.js API"
โ†’ Score: web_application (85 points)
โ†’ Auto-assembles: Frontend + Backend + Full Stack + QA + DevOps + MCP experts

๐Ÿง  Memory System & Session Continuity

Advanced Context Preservation:

  • Project-Specific Templates: Automatically creates .memory/ui-components.md for web apps, .memory/model-architecture.md for AI projects
  • Real-Time State Tracking: Continuous updates to project progress, decisions, and collaboration history
  • Auto-Compact Handling: Complete project state restoration after context compression
  • Session Continuity: Seamless work continuation across development sessions

๐Ÿ† Quality-First Development

Automated Quality Gates:

Quality Standards by Project Type:
web_application:
  - TypeScript coverage: 95% (auto-measured)
  - Core Web Vitals: LCP<2.5s, FID<100ms, CLS<0.1 (auto-verified)
  - Accessibility: WCAG 2.1 AA compliance (auto-checked)
  - Security: Zero vulnerabilities (auto-scanned)

ai_ml_system:
  - Model accuracy: >90% (auto-evaluated)
  - Inference latency: <100ms (auto-measured)
  - Data quality: >95% completeness (auto-verified)

๐Ÿค Expert Collaboration System

Signal-Based Coordination:

  • [PROMPT_LOADED:{expert}:VERIFIED]: Expert activation with prompt validation
  • [COLLAB_REQUEST:{task_id}]: Cross-expert consultation requests
  • [TASK_DONE:{task_id}:{expert}]: Task completion with deliverable validation
  • Dynamic Re-engagement: Experts remain available for refinements and updates

๐Ÿ’Ž Why This Changes Everything

๐ŸŽฏ For Users - Simplicity at Scale

  • One Request = Complete System: "Create an e-commerce platform" โ†’ Full development team activated
  • Zero Configuration: No setup complexity, intelligent defaults handle everything
  • Session Continuity: Work seamlessly across days, weeks, or months
  • Quality Guaranteed: Enterprise-grade quality standards automatically enforced

๐Ÿค– For LLM Runtimes - Optimized Execution

  • Memory-Efficient: Project-specific templates minimize context usage
  • Execution-Focused: Concrete protocols instead of abstract documentation
  • Integration-Ready: All components work together seamlessly
  • Platform-Agnostic: Works across Claude Code, Codex, Gemini CLI, and Junie

๐ŸŽฎ Real-World Usage Examples

๐ŸŒ Web Application Development

User: "Create a modern e-commerce platform with React and Node.js"

AI System Response:
โœ… Project Type: web_application (detected with 92% confidence)
โœ… Expert Team: Frontend + Backend + Full Stack + QA + DevOps + MCP
โœ… Memory Templates: ui-components.md, api-endpoints.md, user-flows.md
โœ… Quality Standards: TypeScript 95%, Core Web Vitals, WCAG AA, Security scan
โœ… Workflow: Requirements โ†’ Architecture โ†’ Implementation โ†’ Testing โ†’ Deployment

๐Ÿค– AI/ML System Development

User: "Build an image classification model with TensorFlow"

AI System Response:
โœ… Project Type: ai_ml_system (detected with 88% confidence)
โœ… Expert Team: System Dev + Research + Backend + QA + MCP
โœ… Memory Templates: model-architecture.md, data-pipeline.md, training-requirements.md
โœ… Quality Standards: 90% accuracy, <100ms latency, data quality validation
โœ… Workflow: Research โ†’ Architecture โ†’ Model Dev โ†’ Validation โ†’ Deployment

๐Ÿ“ฑ Mobile Application Development

User: "Create a React Native social media app"

AI System Response:
โœ… Project Type: mobile_application (detected with 85% confidence)
โœ… Expert Team: Frontend + Backend + DevOps + QA + MCP
โœ… Memory Templates: platform-requirements.md, performance-targets.md
โœ… Quality Standards: Platform compatibility, performance benchmarks
โœ… Workflow: Requirements โ†’ Architecture โ†’ Development โ†’ Testing โ†’ Store Deploy

๐Ÿ”ง Advanced Configuration

๐ŸŽฏ Automatic System Validation

# Quick system health check
./setup-validator.sh

# Verify expert prompt loading
./validate-prompts.sh

# Test project detection
./test-detection.sh "Create a React dashboard"

๐Ÿง  Memory System Deep Dive

Intelligent Context Management:

Memory Templates by Project Type:
web_application:
  - .memory/ui-components.md      # Component library tracking
  - .memory/api-endpoints.md      # API documentation
  - .memory/user-flows.md         # UX workflow tracking

ai_ml_system:
  - .memory/model-architecture.md # Model design decisions
  - .memory/data-pipeline.md      # Data processing workflows
  - .memory/training-requirements.md # Training parameters

mobile_application:
  - .memory/platform-requirements.md # iOS/Android specifics
  - .memory/performance-targets.md   # Performance benchmarks

Auto-Compact Session Continuity:

  • Pre-Compact: Automatic project state preservation
  • Post-Restore: Complete context reconstruction with expert reactivation
  • Continuous Tracking: Real-time progress and decision logging

โš™๏ธ MCP Tool Integration

Available MCP Servers:

  • GitHub MCP: Repository management, code examples, issue tracking
  • Context7: Up-to-date documentation and API references
  • Playwright MCP: Advanced browser automation and testing
  • Sequential Thinking: Complex problem-solving and analysis

Auto-Configuration:

# Claude Code setup (includes auto-compact hooks)
cp .mcp/settings-npx.json ~/.claude/settings.json
cp .claude/settings.json .claude/settings.json

# Verify MCP integration
claude-code --validate-mcp

๐Ÿš€ Ready to Transform Your Development?

๐ŸŒŸ Get Started Today

  1. Clone the repository:

    git clone https://github.com/HanTechnology/dev-ai-agent-team-boilerplate.git
    cd dev-ai-agent-team-boilerplate
  2. Run the installer for your LLM:

    ./install-claude.sh    # For Claude Code (recommended)
    ./install-gemini.sh    # For Gemini CLI
    ./install-codex.sh     # For Codex
    ./install-junie.sh     # For Junie
  3. Start building:

    "Create a modern web application with React and Node.js"
    

๐Ÿ’Ž Join the AI Development Revolution

This isn't just a boilerplateโ€”it's the future of AI-powered development. Experience:

  • โšก Instant Expert Teams: Specialized AI experts assembled automatically
  • ๐Ÿง  Intelligent Memory: Context that persists and evolves with your project
  • ๐Ÿ† Quality Guaranteed: Enterprise-grade standards enforced automatically
  • ๐Ÿ”„ Session Continuity: Seamless work across days, weeks, and months

๐Ÿ“„ License

MIT License - Use, modify, and distribute freely. Build the future of AI development.

๐Ÿ™ Acknowledgments

Powered by the convergence of advanced LLM capabilities, collaborative AI coordination, and real-world development expertise. This system represents hundreds of hours of integration testing and optimization across multiple LLM CLI runtimes.

Built for the AI development community by developers who understand the challenges of complex project coordination.


โญ Star this repository if it transforms your development workflow!

๐Ÿค Contribute: Help us make AI development even more powerful - PRs welcome!

๐Ÿ’ฌ Community: Share your experiences and get help in our discussions

About

๐Ÿš€ Orchestrate Your AI Agent Team. This boilerplate provides a powerful, CLI-based runtime to build, test, and deploy collaborative AI agents. Featuring a modular architecture for clean separation of agent logic, shared state management, and streamlined interaction protocols. Jumpstart your multi-agent LLM project now.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors