Ai Plan Generator

Generates comprehensive campaign documents, task decompositions, and context documents from minimal input for ClawTeam continuous iteration. Supports Code Archaeology integration with unified directory structure.

AI Plan Generator v2

AI Plan Generator v2 extends the original business functionality decomposition with comprehensive campaign document generation, task decomposition, context document generation, and Code Archaeology integration for ClawTeam continuous iteration.

Core Capabilities

1. Campaign Document Generation

• Minimal Input Processing: Only 4 key inputs required (project name, business goal, scope boundary, code location)
• Multi-Language Support: Java, Python, Go, C#, Rust, JavaScript
• Project Type Detection: Automatically identifies new vs iteration projects
• Domain-Specific Templates: Finance, User Management, General domains

2. Task Decomposition

• Detailed Task Generation: Complete tasks with priorities, dependencies, acceptance criteria
• Multiple Output Formats: JSON, Markdown, ClawTeam formats
• Domain-Specific Tasks: Finance (payment, invoicing, reconciliation), User (auth, permissions)
• Source File Location: Precise source code location tracking

3. Context Document Generation

• Business Rules: AI-executable business constraints and validation rules
• Technical Specifications: Data models, API contracts, integration specifications
• Validation Standards: Comprehensive testing requirements and coverage criteria
• Integration Configuration: External system configuration with timeout/retry settings

4. Code Archaeology Integration

• Unified Directory Structure: results/, process/, source/ subdirectories
• Real Analysis Results: Extracts precise information from actual Code Archaeology output
• Completeness Analysis: Validates document completeness and AI executability
• Clarification Questions: Automatically generates questions for missing/incomplete information

Unified Workflow

Complete End-to-End Process

# 1. Generate complete workflow from minimal input
ai-plan-generator generate-complete-workflow input.json /path/to/code-archaeology

# 2. Creates standardized directory structure:
project-name/
├── project-name-campaign.md          # Campaign document
├── task-decomposition/              # Task decomposition  
│   ├── tasks.json                   # JSON format
│   ├── tasks.md                     # Markdown format
│   └── clawteam-tasks.json          # ClawTeam format
├── context-documents/               # Context documents
│   ├── business-rules.json          # Business rules
│   ├── technical-specs.yaml         # Technical specifications
│   ├── validation-standards.md      # Validation standards
│   ├── integration-config.json       # Integration configuration
│   └── analysis-report.json         # Completeness analysis report
└── process-files-report.json        # Process file location report

Code Archaeology Integration

# Convert Code Archaeology results to AI Plan Generator format
ai-plan-generator generate-context-from-archaeology \
  /path/to/project_code_archaeology \
  context-documents \
  finance

Minimal Input Requirements

Only 4 key pieces of information are required:

{
  "projectName": "dms-erp-finance-migration-v1",
  "businessGoal": "Migrate financial module to Java", 
  "scopeBoundary": "Backend services only, no frontend",
  "codeLocation": "src/main/java/com/dms/financialmanagement/"
}

Domain-Specific Intelligence

Financial Domain

• Payment Processing: Contract payment handling with amount validation
• Invoice Generation: Tax calculation, invoice types, compliance
• Account Reconciliation: Partial refunds, multiple reconciliations
• Security Requirements: Hardcoded credential removal, SQL injection prevention

User Management Domain

• Authentication: Registration, login, session management
• Authorization: Role-based permissions, fine-grained access control
• Security: Password complexity, OAuth integration, CSRF protection

ClawTeam Integration

Generated artifacts are directly compatible with ClawTeam:

• Campaign Documents: Used as team description for clawteam create
• Task Decomposition: Directly importable as clawteam task create commands
• Context Documents: Provide AI-executable reference for agent implementation
• Completeness Analysis: Ensures high-quality input before team creation

Best Practices

Input Quality

• Project Name: Include domain keywords (finance, user, order)
• Business Goal: Be specific about core business value
• Scope Boundary: Clearly define inclusions/exclusions
• Code Location: Use complete package paths

Iteration Strategy

• Start Simple: Begin with minimal input, let AI infer details
• Validate Early: Run completeness analysis before team creation
• Clarify Issues: Address high-priority clarification questions
• Iterate Refinement: Use feedback to improve subsequent iterations

Example Use Cases

Legacy PHP to Java Migration

Input: Financial module migration from zbs_php to dms-erp Output: Complete campaign document with security remediation, task decomposition with data migration tasks, context documents with precise business rules

New Microservice Development

Input: Create new user authentication service Output: Campaign document with architecture decisions, task decomposition with OAuth integration, context documents with security requirements

API Modernization

Input: Standardize legacy RPC APIs to RESTful design Output: Campaign document with versioning strategy, task decomposition with backward compatibility, context documents with API specifications

AI Plan Generator v2 transforms minimal input into comprehensive, AI-executable documentation that powers successful ClawTeam continuous iteration.