ai-plan-generator

# 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 ```bash # 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 ```bash # 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: ```json { "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.