archon-agent-kit-prp-automated/AI_CHOICE.md

🚀 BREAKTHROUGH: Automated PRP Generation System - No more copying templates! Generates complete, customized PRPs automatically with 85.7% quality validation. Supports all project types: Web, Mobile, API, CLI, Microservices.

# 🤖 AI Choice Selection Guide

## Welcome to Archon-Agent-Kit-PRP-Automated v2.0.0!

**🚀 Need the simple steps?** → [**steps.md**](./steps.md) - Get your PRPs in 2 minutes!

**🎉 BREAKTHROUGH: Automated PRP Generation System** - No more copying templates! The system now generates complete, customized PRPs automatically with 85.7% quality validation.

Archon-Agent-Kit-PRP-Automated is designed to work with **multiple AI coding assistants**. Choose your preferred AI tool to get the most optimized experience for the new automated workflow.

## 🎯 **Choose Your AI Assistant**

### **Option 1: Claude (Anthropic)**
- **Best for**: Detailed analysis, comprehensive explanations, complex reasoning
- **Interface**: Claude web app, Claude Desktop, or Claude Pro
- **Commands**: Use the `.claude/commands/` directory
- **Workflow**: `/initialize-project` → **🔥 Get 4 Complete PRPs Automatically** → `/prime-core` → `/generate-next-steps`

### **Option 2: Cursor (Cursor AI)**
- **Best for**: Integrated development, real-time assistance, code completion
- **Interface**: Cursor IDE with built-in AI features
- **Commands**: Use the `.cursor/commands/` directory
- **Workflow**: "Initialize project from INITIAL.md" → **🔥 Get 4 Complete PRPs Automatically** → AI chat → "Generate next steps"

### **Option 3: Other AI Assistants**
- **Best for**: Custom workflows, specific AI tool preferences
- **Interface**: Various AI platforms and tools
- **Commands**: Adapt commands from `.claude/` or `.cursor/` directories
- **Workflow**: Customize based on your AI tool's capabilities

## 🚀 **Getting Started**

### **Step 1: Choose Your AI**
Decide which AI coding assistant you want to use for this project.

### **Step 2: Copy Archon-Agent-Kit-PRP-Automated**
```bash
cp -r Archon-Agent-Kit-PRP-Automated/ /path/to/new/project/
cd /path/to/new/project/
```

### **Step 3: Follow AI-Specific Instructions**

#### **For Claude Users:**
1. Use `.claude/commands/` directory
2. Run `/initialize-project INITIAL.md`
3. **🎉 BREAKTHROUGH: Get 4 Complete PRPs Automatically!**
   - Planning PRP with extracted goals & constraints
   - API Contract with endpoints & data models
   - Implementation PRP with tech-specific details
   - Task breakdown with acceptance criteria
4. Run `/prime-core` with your generated context
5. Run `/generate-next-steps` for intelligent guidance
6. **Your PRPs are ready to use immediately - no manual creation needed!**

#### **For Cursor Users:**
1. Use `.cursor/commands/` directory
2. Type: "Initialize project from INITIAL.md"
3. **🎉 BREAKTHROUGH: Get 4 Complete PRPs Automatically!**
   - Planning PRP with extracted goals & constraints
   - API Contract with endpoints & data models
   - Implementation PRP with tech-specific details
   - Task breakdown with acceptance criteria
4. Use Cursor's AI chat with your generated context
5. Type: "Generate next steps for project development"
6. **Your PRPs are ready to use immediately - no manual creation needed!**

#### **For Other AIs:**
1. Adapt commands from either directory
2. Customize workflow for your AI tool
3. Follow the general Archon-Agent-Kit-PRP-Automated workflow

## 📁 **Directory Structure**

```
Archon-Agent-Kit-PRP-Automated/
├── .claude/                    # Claude-specific commands
│   └── commands/
│       ├── project-setup/
│       │   ├── initialize-project.md
│       │   └── generate-next-steps.md
│       └── prp-creation/      # PRP creation commands
│           ├── prp-planning-create.md
│           ├── api-contract-define.md
│           ├── prp-base-create.md
│           ├── prp-base-execute.md
│           ├── prp-spec-create.md
│           ├── prp-spec-execute.md
│           ├── prp-task-create.md
│           └── prp-task-execute.md
├── .cursor/                    # Cursor-specific rules
│   └── rules/                  # Cursor rules (.mdc files)
│       ├── initialize-project.mdc
│       ├── generate-next-steps.mdc
│       ├── prp-planning-create.mdc
│       ├── prp-base-create.mdc
│       ├── prp-base-execute.mdc
│       ├── prp-spec-create.mdc
│       ├── prp-spec-execute.mdc
│       ├── prp-task-create.mdc
│       ├── prp-task-execute.mdc
│       └── api-contract-define.mdc
├── project-initializers/       # Shared Python backend
├── claude_md_files/           # Shared CLAUDE.md files
├── PRPs/                      # Shared PRP templates
├── README.md                  # Main documentation
└── AI_CHOICE.md               # This file
```

## 🔥 **The Big Breakthrough: Automated PRP Generation**

### **What Happens When You Run `/initialize-project`:**
1. **Technology Detection**: Automatically detects your tech stack from INITIAL.md
2. **Requirements Extraction**: Extracts goals, constraints, features, and success criteria
3. **Pattern Matching**: Identifies best practices for your technology choices
4. **🔥 PRP Generation**: Creates 4 complete, customized PRPs automatically:
   - **Planning PRP**: Complete project planning with extracted requirements
   - **API Contract**: API specification with endpoints and data models
   - **Implementation PRP**: Technical implementation details and architecture
   - **Task PRPs**: Breakdown of development tasks with acceptance criteria
5. **Quality Validation**: Scores and validates generated PRPs
6. **Project Structure**: Sets up appropriate directories and configuration files

### **No More Manual Work:**
- ❌ **Before**: Copy templates, fill in manually, guess what to include
- ✅ **Now**: Get complete, project-specific PRPs in 2 minutes
- 🎯 **Result**: Save 2-4 hours per project with professional-quality PRPs

## 🔄 **Shared vs. AI-Specific**

### **Shared Components (All AIs):**
- **Python Backend**: `project-initializers/` - Core automation logic
- **CLAUDE.md Files**: `claude_md_files/` - Technology-specific guidelines
- **PRP Templates**: `PRPs/` - Feature development templates
- **Project Structure**: Generated automatically based on INITIAL.md

### **AI-Specific Components:**
- **Commands**: Different command formats for each AI
- **Workflow**: Optimized interaction patterns
- **Documentation**: AI-specific usage instructions
- **Integration**: Platform-specific features and capabilities

## �� **Why Multiple AI Support?**

### **User Choice**: Different developers prefer different AI tools
### **Platform Optimization**: Each AI has unique strengths and interfaces
### **Workflow Flexibility**: Adapt to your existing development habits
### **Future-Proofing**: Easy to add support for new AI tools

## 🚀 **Quick Start Commands**

### **Claude:**
```bash
/initialize-project INITIAL.md
# 🎉 Get 4 Complete PRPs Automatically!
/prime-core
/generate-next-steps
```

### **Cursor:**
```
Initialize project from INITIAL.md
# 🎉 Get 4 Complete PRPs Automatically!
[Use Cursor's AI chat with generated context]
Generate next steps for project development
```

### **Other AIs:**
Adapt the commands above to your AI tool's interface and capabilities.

## 🔧 **Customization**

### **Adding New AI Support:**
1. Create `.your-ai/commands/` directory
2. Adapt command files from existing directories
3. Customize workflow for your AI's capabilities
4. Update this guide with your AI's instructions

### **Modifying Commands:**
- Edit files in the appropriate AI-specific directory
- Maintain consistency across AI versions
- Test commands with your AI tool
- Update documentation as needed

## 🎉 **Ready to Start?**

1. **Choose your AI assistant** from the options above
2. **Follow the AI-specific instructions** for your chosen tool
3. **Create your INITIAL.md** with project specifications
4. **Run the initialization** using your AI's commands
5. **🎉 Get 4 Complete PRPs Automatically** - no manual work needed!
6. **Enjoy automated project setup** with intelligent guidance and ready-to-use PRPs!

---

**Archon-Agent-Kit-PRP-Automated v2.0.0**: Where project initialization meets artificial intelligence and **automated PRP generation**, regardless of your AI preference! 🚀��