UNPKG

mirror-magi-meta-agent

Version:

AI-powered development planning and execution system with Supabase integration

104 lines (87 loc) โ€ข 3.43 kB
# ๐Ÿ“ Project Structure *Clean, organized structure for the Mirror Magi Meta-Agent* --- ## ๐Ÿ—๏ธ Directory Layout ``` meta-agent/ โ”œโ”€โ”€ bin/ # Global CLI commands โ”‚ โ””โ”€โ”€ cli.js # mirror-magi command โ”‚ โ”œโ”€โ”€ core/ # Core engines โ”‚ โ”œโ”€โ”€ template-engine.js # Command generation โ”‚ โ”œโ”€โ”€ task-classifier.js # Task classification โ”‚ โ””โ”€โ”€ context-builder.js # Context management โ”‚ โ”œโ”€โ”€ scripts/ # All executable scripts โ”‚ โ”œโ”€โ”€ validation/ # Validation tools โ”‚ โ”‚ โ””โ”€โ”€ validate-plan.js # Plan structure validator โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ planning/ # Planning tools โ”‚ โ”‚ โ””โ”€โ”€ view-complete-plan.js # Complete plan viewer โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ execution/ # Execution tools โ”‚ โ”‚ โ””โ”€โ”€ plan-project.js # Main execution engine โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ legacy/ # Optional/advanced tools โ”‚ โ”‚ โ”œโ”€โ”€ interactive-planner.js โ”‚ โ”‚ โ”œโ”€โ”€ edit-plan.js โ”‚ โ”‚ โ”œโ”€โ”€ discuss-plan.js โ”‚ โ”‚ โ””โ”€โ”€ convert-ai-plan.js โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ setup.js # Initial setup script โ”‚ โ””โ”€โ”€ validate-config.js # Config validator โ”‚ โ”œโ”€โ”€ config/ # Configuration templates โ”‚ โ”œโ”€โ”€ project-config.template.json โ”‚ โ”œโ”€โ”€ agent-persona.template.md โ”‚ โ””โ”€โ”€ command-templates.json โ”‚ โ”œโ”€โ”€ templates/ # Command templates โ”‚ โ””โ”€โ”€ [various templates] โ”‚ โ”œโ”€โ”€ state/ # Runtime state (gitignored) โ”‚ โ””โ”€โ”€ master-plan.json # Current plan โ”‚ โ”œโ”€โ”€ docs/ # Documentation โ”‚ โ””โ”€โ”€ guides/ # Detailed guides โ”‚ โ”œโ”€โ”€ PLANNING_WORKFLOW.md โ”‚ โ”œโ”€โ”€ PLAN_STRUCTURE_GUIDE.md โ”‚ โ”œโ”€โ”€ AI_TO_STRUCTURED_PLAN_GUIDE.md โ”‚ โ””โ”€โ”€ AI_PLAN_VALIDATION_GUIDE.md โ”‚ โ”œโ”€โ”€ test-agent.js # Demo/test script โ”œโ”€โ”€ generate-command.js # Single command generator โ”œโ”€โ”€ index.js # Programmatic API โ”œโ”€โ”€ package.json # Package configuration โ”œโ”€โ”€ README.md # Main documentation โ”œโ”€โ”€ GETTING_STARTED.md # Quick start guide โ”œโ”€โ”€ CORE_SCRIPTS.md # Command reference โ””โ”€โ”€ PROJECT_STRUCTURE.md # This file ``` --- ## ๐ŸŽฏ Key Files ### Essential Scripts - `scripts/validation/validate-plan.js` - Validates AI plans - `scripts/execution/plan-project.js` - Executes plans - `scripts/planning/view-complete-plan.js` - Views plans ### Documentation - `README.md` - System overview - `GETTING_STARTED.md` - 5-minute setup - `CORE_SCRIPTS.md` - All commands ### Configuration - `config/` - Templates for setup - `state/` - Runtime data (user-specific) --- ## ๐Ÿš€ Workflow 1. **Generate** - Use AI to create plan 2. **Structure** - Format as JSON 3. **Validate** - Check with `validate-plan.js` 4. **Execute** - Run with `plan-project.js` --- ## ๐Ÿงน Clean Design - **Organized scripts** - Grouped by purpose - **Clear separation** - Core vs optional tools - **User data isolated** - State folder gitignored - **Simple workflow** - Essential tools prominent --- *A streamlined structure for AI-powered development*