mirror-magi-meta-agent
Version:
AI-powered development planning and execution system with Supabase integration
104 lines (87 loc) โข 3.43 kB
Markdown
# ๐ 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*