--- name: Framework Orchestrator description: Meta-skill that coordinates all frameworks and skills throughout the project lifecycle, providing intelligent sequencing based on project patterns version: 1.0.0 category: orchestration triggers: - 'framework-orchestrator' - 'framework orchestrator' - 'orchestrate frameworks' - 'coordinate skills' - 'project orchestration' dependencies: required_mcps: [] required_tools: [] required_integrations: [] --- # Framework Orchestrator ## Overview The Framework Orchestrator is the meta-skill that coordinates all other skills and frameworks throughout your project lifecycle. It analyzes your project, identifies the appropriate pattern, and sequences frameworks and skills in the optimal order. **Think of it as:** Your AI project manager that knows when to apply which methodology. ## When to Use This Skill Use Framework Orchestrator when: - Starting a new project and need guidance on methodology - Unsure which frameworks or skills to apply first - Want a complete orchestrated plan for your project - Need to understand your project's complexity pattern - Transitioning between project phases - Managing multiple workstreams in parallel ## Key Capabilities - Analyze projects and identify complexity patterns (A, B, C) - Recommend optimal framework sequences - Coordinate skill activation at appropriate phases - Provide phase-gate validation - Adapt orchestration based on project evolution - Ensure comprehensive coverage across all dimensions ## Workflow ### Step 1: Pattern Identification **Analyze the project and categorize into one of three patterns:** #### Pattern A: Simple Feature/Enhancement **Characteristics:** - Adding to existing system - Well-understood requirements - Low risk, minimal security impact - Single-team, short timeline (days to 1-2 weeks) **Examples:** - Add filter to existing search - New dashboard widget - Form field additions - UI styling updates **Timeline:** 1-5 days --- #### Pattern B: New Product/System **Characteristics:** - Building from scratch or major module - User validation needed - Security/compliance important - Multiple considerations (UX, architecture, testing) - Medium timeline (weeks to months) **Examples:** - New SaaS product - Customer portal - Internal tool - API platform **Timeline:** 4-12 weeks --- #### Pattern C: AI-Native/Complex System **Characteristics:** - All Pattern B characteristics, PLUS: - AI agents, RAG systems, or knowledge graphs - Complex orchestration - Novel technology - Higher uncertainty and iteration **Examples:** - Multi-agent AI system - RAG-powered knowledge base - Intelligent automation platform - AI-assisted decision support **Timeline:** 8-20 weeks --- ### Step 2: Framework Selection **Based on pattern, recommend framework sequence:** #### Pattern A Sequence (Simple Feature) 1. **simple_feature_framework** - Lightweight requirements and validation 2. **code-quality-enforcer** - Ensure code standards 3. **testing-strategist** - Unit test coverage 4. **deployment-advisor** - Ship quickly **Coordinating Skills:** - quality-assurance (testing) - performance-optimizer (if needed) --- #### Pattern B Sequence (New Product) **Phase 1: Discovery & Validation** - **discovery_validation_framework** - User research and problem validation - **product_market_fit_framework** - Market analysis and positioning - **prp-generator** skill - Create Product Requirements Prompt - **user-researcher** skill - Conduct user interviews **Phase 2: Architecture & Design** - **bmad-method** skill - Business model and architecture alignment - **design_prototyping_framework** - Wireframes and prototypes - **ux-designer** skill - User journey mapping - **security-architect** skill - Threat modeling and security design - **api-designer** skill (if applicable) - API contract design **Phase 3: Development** - **full_stack_dev_framework** - Implementation guidance - **frontend-builder** / **api-designer** skills - Build UI and backend - **quality-assurance** skill - Code quality and testing **Phase 4: Testing & Validation** - **testing_validation_framework** - Comprehensive testing strategy - **quality-assurance** skill - Test pyramid execution - **usability-tester** skill - User acceptance testing - **security-architect** skill - Security testing **Phase 5: Deployment & Launch** - **deployment_devops_framework** - CI/CD and infrastructure - **deployment-advisor** skill - Deployment strategy - **go-to-market-planner** skill - Launch planning --- #### Pattern C Sequence (AI-Native) **All Pattern B phases, PLUS:** **Phase 2b: AI Architecture (parallel with standard architecture)** - **multi-agent-architect** skill - Agent system design - **rag-implementer** skill - RAG architecture (if applicable) - **knowledge-graph-builder** skill - Knowledge structure (if applicable) - **agentic-workflow-orchestration-framework** - Agent coordination **Phase 3b: AI Development (integrated with standard development)** - **context_engineering_framework** - Prompt and context design - **multi_agent_orchestration_framework** - Agent implementation **Phase 4b: AI Testing (additional testing layer)** - Test agent behaviors and edge cases - Validate RAG retrieval quality - Benchmark LLM performance --- ### Step 3: Phase Orchestration **Execute phases with validation gates:** #### Phase Gate Structure **Entry to Phase 2 (Design):** - PRP document complete - Problem statement validated - Success metrics defined - User stories documented **Entry to Phase 3 (Development):** - Architecture documented - Data model designed - Security threats identified - Mitigations planned **Entry to Phase 4 (Testing):** - Features complete - Unit tests >80% coverage - Code review passed - SAST scans clean **Entry to Phase 5 (Deployment):** - All tests passing - UAT completed - Security testing done - Coverage >90% --- ### Step 4: Skill Coordination **Orchestrate skills based on current phase:** **Discovery Phase Skills:** - user-researcher - product-strategist - product-analyst **Design Phase Skills:** - ux-designer - design-system-architect - bmad-method - security-architect **Development Phase Skills:** - frontend-builder - api-designer - multi-agent-architect (Pattern C) - rag-implementer (Pattern C) - mvp-builder **Testing Phase Skills:** - quality-assurance - usability-tester - security-architect **Deployment Phase Skills:** - deployment-advisor - go-to-market-planner - performance-optimizer **Post-Launch Skills:** - product-analyst - customer-feedback-analyzer - performance-optimizer --- ## Examples ### Example 1: SaaS Analytics Platform (Pattern B) **Project Analysis:** - New product from scratch - B2B SaaS model - Security and compliance important - 8-week timeline **Recommended Sequence:** **Week 1: Discovery** 1. discovery_validation_framework 2. user-researcher skill → User interviews 3. product-strategist skill → Market validation 4. prp-generator skill → Create PRP **Week 2: Architecture** 5. bmad-method skill → Business model + architecture alignment 6. design_prototyping_framework → Wireframes 7. ux-designer skill → User journeys 8. api-designer skill → API design 9. security-architect skill → Threat model **Week 3-6: Development** 10. full_stack_dev_framework 11. frontend-builder skill → Build React UI 12. api-designer skill → Build backend 13. quality-assurance skill → Continuous testing **Week 7: Testing** 14. testing_validation_framework 15. quality-assurance skill → Test pyramid 16. usability-tester skill → User testing 17. security-architect skill → Security testing **Week 8: Deployment** 18. deployment_devops_framework 19. deployment-advisor skill → Deploy to production 20. go-to-market-planner skill → Launch plan --- ### Example 2: Multi-Agent Customer Support System (Pattern C) **Project Analysis:** - AI-native system with multiple agents - RAG for knowledge retrieval - Complex orchestration - 12-week timeline **Recommended Sequence:** **Week 1-2: Discovery (same as Pattern B)** **Week 3-4: Architecture** - bmad-method skill - security-architect skill - **multi-agent-architect skill** → Agent system design - **rag-implementer skill** → RAG architecture - **knowledge-graph-builder skill** → Knowledge structure - agentic-workflow-orchestration-framework **Week 5-9: Development** - full_stack_dev_framework - frontend-builder skill - **multi-agent-architect skill** → Agent implementation - **rag-implementer skill** → Vector DB + embeddings - context_engineering_framework → Prompt design - quality-assurance skill **Week 10-11: Testing** - testing_validation_framework - quality-assurance skill - **Test agent behaviors, RAG quality, LLM performance** - usability-tester skill **Week 12: Deployment** - deployment_devops_framework - deployment-advisor skill - go-to-market-planner skill --- ### Example 3: Add User Export Feature (Pattern A) **Project Analysis:** - Enhancement to existing system - Well-understood requirements - Low complexity - 3-day timeline **Recommended Sequence:** **Day 1:** 1. simple_feature_framework → Define requirements 2. api-designer skill → Design export endpoint **Day 2:** 3. Build backend + frontend 4. quality-assurance skill → Unit tests **Day 3:** 5. testing-strategist skill → Integration tests 6. deployment-advisor skill → Deploy to staging, then production --- ## Best Practices ### 1. Always Start with Pattern Identification Don't jump to frameworks. First understand: - Scope (simple feature, new product, AI system) - Timeline (days, weeks, months) - Risk (low, medium, high) ### 2. Respect Phase Gates Don't skip validation checkpoints. Each gate ensures: - Previous work is complete - Next phase has proper foundation - Risks are identified and mitigated ### 3. Parallelize When Possible Some work can run in parallel: - UX design + Architecture design (Phase 2) - Frontend + Backend development (Phase 3) - Test writing + Feature development (Phase 3) ### 4. Adapt Orchestration Based on Reality If project evolves: - Pattern A → Pattern B: Add discovery and design phases - Pattern B → Pattern C: Add AI architecture and testing - Scope reduction: Simplify orchestration ### 5. Coordinate Skills, Don't Overwhelm Don't activate all skills at once. Sequence them: - 1-3 skills per phase maximum - Clear handoffs between skills - Each skill has specific deliverable --- ## Common Pitfalls ### 1. Mis-Identifying Pattern **Antipattern:** Treating Pattern B (new product) as Pattern A (simple feature) **Result:** Skip discovery, build wrong thing **Fix:** If any uncertainty exists, default to Pattern B ### 2. Skipping Phases **Antipattern:** Jump straight to development without design **Result:** Rework, missed requirements, security gaps **Fix:** Respect the sequence, validate phase gates ### 3. Over-Orchestrating Simple Features **Antipattern:** Use full Pattern B orchestration for a button color change **Result:** Waste time on unnecessary process **Fix:** Pattern A is valid for truly simple work ### 4. Under-Orchestrating Complex Projects **Antipattern:** Build AI system without proper architecture phase **Result:** Technical debt, poor performance, rewrites **Fix:** Pattern C requires comprehensive orchestration ### 5. Ignoring Phase Gates **Antipattern:** Move to development with incomplete architecture **Result:** Build on shaky foundation, blockers mid-development **Fix:** Enforce phase gates, document readiness --- ## Related Skills - **prp-generator** - Creates requirements (called by orchestrator in Phase 1) - **bmad-method** - Business/architecture alignment (Phase 2) - **security-architect** - Security design (Phase 2 & 4) - **quality-assurance** - Testing strategy (Phase 3 & 4) - **deployment-advisor** - Infrastructure (Phase 5) - **All other skills** - Activated by orchestrator at appropriate phases --- ## Deliverables When using Framework Orchestrator, produce: 1. **Pattern Identification** - Pattern: A, B, or C - Rationale for classification - Estimated timeline 2. **Orchestration Plan** - Phase breakdown - Framework sequence - Skill activation points - Phase gate criteria 3. **Current Phase Status** - Where you are now - Completion percentage - Gate criteria readiness - Next steps 4. **Risk & Adaptation Plan** - Identified risks - Contingency plans - When to adapt orchestration --- ## Success Metrics Successful orchestration means: - Right pattern identified (no mis-classification) - Frameworks applied in optimal sequence - Phase gates enforced and passed - Skills activated at appropriate times - No major rework due to skipped phases - Team clarity on current phase and next steps - Project delivered with appropriate quality for pattern --- **Remember:** The orchestrator ensures you apply the right methodology at the right time. It's the difference between organized development and chaotic thrashing.