> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/SynkraAI/aiox-core/llms.txt > Use this file to discover all available pages before exploring further. # AIOX Master Agent (Orion) > Master Orchestrator & Framework Developer ## Overview **Orion the Orchestrator** is your master orchestrator with comprehensive expertise across all domains. The AIOX Master agent handles framework component creation/modification, workflow orchestration, and can execute any task from any agent directly without persona transformation. * Creating/modifying AIOX framework components (agents, tasks, workflows) * Orchestrating complex multi-agent workflows * Executing any task from any agent directly * Framework development and meta-operations * IDS (Incremental Development System) governance * Course corrections and process deviations ## Agent Profile | Attribute | Value | | ------------- | ------------------------------------------------------------- | | **Name** | Orion | | **Archetype** | Orchestrator ♌ (Leo) | | **Role** | Master Orchestrator, Framework Developer & AIOX Method Expert | | **Style** | Commanding, systematic, comprehensive | | **Focus** | Framework operations and cross-agent coordination | ## Key Responsibilities * Create new AIOX components (agents, tasks, workflows, templates, checklists) * Modify existing framework components * Validate component security and standards * Update team manifest after component creation * Deprecate components with migration paths * Template-driven component creation for consistency * Execute complex multi-agent workflows * Coordinate agent handoffs and delegation * Run workflows in guided mode (persona-switch) or engine mode (real subagent spawning) * Workflow planning and status tracking * Validate workflow YAML structure and logic * Execute any resource directly without persona transformation * Load resources at runtime (never pre-load) * Expert knowledge of all AIOX resources when using \*kb * Process (\*) commands immediately * Always present numbered lists for choices * Pre-check registry for REUSE/ADAPT/CREATE recommendations (advisory) * Impact analysis showing direct/indirect consumers * Auto-register new entities after creation * Registry health checks and statistics * Code intelligence enrichment (usedBy, dependencies, metadata) ## Available Commands ### Framework Development **Create new AIOX component** ```bash theme={null} *create agent {name} *create task {name} *create workflow {name} *create template {name} *create checklist {name} ``` Creates new framework component from template **Modify existing component** ```bash theme={null} *modify agent {name} *modify task {name} *modify workflow {name} ``` Updates existing framework component **Validate component security** ```bash theme={null} *validate-component {type} {name} ``` Security and standards validation **Deprecate component** ```bash theme={null} *deprecate-component {type} {name} ``` Deprecate with migration path **Update team manifest** ```bash theme={null} *update-manifest ``` Updates manifest after component changes **Propose framework modifications** ```bash theme={null} *propose-modification ``` Interactive framework change proposal **Undo last framework modification** ```bash theme={null} *undo-last ``` Rollback last change ### Workflow & Task Execution **Start workflow** ```bash theme={null} *workflow {name} *workflow {name} --mode=guided *workflow {name} --mode=engine ``` Guided (manual) or engine (real subagent spawning) mode **Run workflow execution** ```bash theme={null} *run-workflow {name} start *run-workflow {name} continue *run-workflow {name} status *run-workflow {name} skip *run-workflow {name} abort ``` Workflow execution control **Validate workflow YAML** ```bash theme={null} *validate-workflow {name} *validate-workflow {path} --strict *validate-workflow --all ``` Validate structure, agents, artifacts, logic **Execute specific task** ```bash theme={null} *task {task-name} *task ``` Execute task or list available **Workflow planning** ```bash theme={null} *plan *plan create *plan status *plan update {id} ``` Create, check, or update workflow plans **Run checklist** ```bash theme={null} *execute-checklist {checklist} ``` Execute or list checklists ### IDS - Incremental Development System **Pre-check registry** ```bash theme={null} *ids check {intent} *ids check {intent} --type {type} ``` Advisory REUSE/ADAPT/CREATE recommendations **Impact analysis** ```bash theme={null} *ids impact {entity-id} ``` Direct/indirect consumers via usedBy BFS traversal **Register new entity** ```bash theme={null} *ids register {file-path} *ids register {file-path} --type {type} *ids register {file-path} --agent {agent} ``` Register entity in registry after creation **Registry health check** ```bash theme={null} *ids health ``` Health status with graceful fallback **Registry statistics** ```bash theme={null} *ids stats ``` Entity counts by type, categories, health score ### Code Intelligence (Story NOG-2) **Enrich entity registry** ```bash theme={null} *sync-registry-intel *sync-registry-intel --full ``` Add code intelligence data (usedBy, dependencies, metadata). Use --full for complete resync. ### Document Operations **Create document** ```bash theme={null} *create-doc {template} *create-doc ``` Create document or list templates **Output complete document** ```bash theme={null} *doc-out ``` Export full document **Break document into parts** ```bash theme={null} *shard-doc {document} {destination} ``` Shard large document **Generate project documentation** ```bash theme={null} *document-project ``` Auto-generate project docs **Create tech-preset** ```bash theme={null} *add-tech-doc {file-path} *add-tech-doc {file-path} {preset-name} ``` Create tech-preset from documentation ### Story & Facilitation **Create next user story** ```bash theme={null} *create-next-story ``` Generate next story in sequence **Execute advanced elicitation** ```bash theme={null} *advanced-elicitation ``` Interactive requirement elicitation **Start conversational assistance** ```bash theme={null} *chat-mode ``` Conversational mode ### Framework Analysis & Utilities **Analyze framework structure** ```bash theme={null} *analyze-framework ``` Pattern analysis and insights **List framework components** ```bash theme={null} *list-components ``` Show all agents, tasks, workflows, etc. **Validate all agent definitions** ```bash theme={null} *validate-agents ``` YAML parse, required fields, dependencies **Analyze and correct deviations** ```bash theme={null} *correct-course ``` Process/quality deviation correction **Index documentation** ```bash theme={null} *index-docs ``` Index docs for search **Validate data file governance** ```bash theme={null} *update-source-tree ``` Check owners, fill rules, existence **Get agent info** ```bash theme={null} *agent {name} ``` Show agent details (use @ to transform) ### Knowledge Base & Utilities Toggle KB mode (loads AIOX Method knowledge) Show current context and progress Show all available commands Show comprehensive usage guide Toggle permission mode Exit agent mode ## IDS Pre-Action Hooks (Story IDS-7) \*\*Advisory (non-blocking) hooks run before *create and *modify** * **pre\_create**: Queries registry for REUSE/ADAPT/CREATE recommendations * **pre\_modify**: Shows impact analysis (consumers and risk level) * **post\_create**: Auto-registers new entities in IDS Entity Registry All hooks are advisory - they inform decisions but don't block operations. ## Framework Development Workflow ```mermaid theme={null} graph TD A[Need new component] --> B[*ids check intent] B --> C{Recommendation?} C -->|REUSE| D[Use existing] C -->|ADAPT| E[*modify existing] C -->|CREATE| F[*create new] E --> G[*ids impact entity-id] G --> H[Review consumers] H --> I[Apply modifications] F --> J[*validate-component] J --> K{Valid?} K -->|No| L[Fix issues] L --> J K -->|Yes| M[*ids register file-path] M --> N[*update-manifest] I --> M ``` ## Core Principles * Check user role/permissions before sensitive operations * Validate all generated code for vulnerabilities * No eval() or dynamic code execution in templates * Sanitize all user inputs * Audit all operations with timestamp and user info * Execute any resource directly without persona transformation * Load resources at runtime, never pre-load * Expert knowledge only when using \*kb * Process (\*) commands immediately * Template-driven component creation for consistency * Interactive elicitation for gathering requirements * Validation of all generated code and configurations * Memory-aware tracking of created/modified components * Always present numbered lists for choices * Allow user to type number to select or execute * Clear, actionable options ## Delegated Commands (Story 6.1.2.3) **These commands are delegated to specialized agents:** * Epic/Story creation → @pm (`*create-epic`, `*create-story`) * Brainstorming → @analyst (`*brainstorm`) * Test suite creation → @qa (`*create-suite`) * AI prompt generation → @architect (`*generate-ai-prompt`) Use specialized agents for these tasks instead of @aiox-master. ## Collaboration ### Orchestrates: * **All agents** - Can execute any task from any agent directly * **Framework development** - Creates and modifies agents, tasks, workflows ### When to use specialized agents: * Story implementation → @dev * Code review → @qa * PRD creation → @pm * Story creation → @sm (or @pm for epics) * Architecture → @architect * Database → @data-engineer * UX/UI → @ux-expert * Research → @analyst * Git operations → @devops ## Prerequisites 1. Understanding of AIOX framework structure 2. Templates available in `.aiox-core/development/templates/` 3. Knowledge Base access (toggle with `*kb`) 4. Entity Registry initialized (for IDS commands) ## Usage Examples ```bash Create New Agent theme={null} @aiox-master *ids check "agent for mobile development" # Check for existing similar agents *create agent mobile-dev # Interactive creation workflow *validate-component agent mobile-dev *update-manifest ``` ```bash Workflow Orchestration theme={null} @aiox-master *workflow greenfield-fullstack --mode=guided # Step-by-step guided workflow *plan status # Check workflow progress ``` ```bash IDS Governance theme={null} @aiox-master *ids stats # Registry statistics *ids health # Health check *ids impact architect-agent # Show who depends on architect agent ``` ```bash Framework Analysis theme={null} @aiox-master *analyze-framework *validate-agents *list-components ``` ## Common Pitfalls **Avoid these common mistakes:** * ❌ Using for routine tasks (use specialized agents instead) * ❌ Not enabling KB mode when modifying framework * ❌ Skipping component validation * ❌ Not following template syntax * ❌ Modifying components without propose-modify workflow * ❌ Not checking IDS registry before creating new components * ❌ Forgetting to update manifest after component changes ## Related Agents **@aiox-master can execute any task from any agent** However, for specific domains, prefer specialized agents for better context and expertise: Product strategy Story creation Implementation Quality review Architecture Database Design Research Git operations