Faion Network Orchestrator

Communication: User's language.

How It Works

code

User task → Analyze intent → Skill tool → Domain skill loads → Execute

CRITICAL: You MUST invoke domain skills using Skill(skill-name). Markdown links do NOT load skills.

Context Discovery

Before routing to a domain skill, gather context to make informed decisions.

Auto-Investigation

If user has an existing project, check these signals FIRST:

Signal	How to Check	Detected → Skip Question
Python/Django	`Glob("**/manage.py")`	Stack question, route to faion-python-developer
Python/FastAPI	`Grep("fastapi", "**/pyproject.toml")`	Stack question, route to faion-python-developer
Node.js/React	`Glob("**/package.json")` + check for react	Stack question, route to faion-javascript-developer
Go project	`Glob("**/go.mod")`	Stack question, route to faion-backend-systems
Rust project	`Glob("**/Cargo.toml")`	Stack question, route to faion-backend-systems
Docker setup	`Glob("**/Dockerfile")`	Infra exists, context for faion-devops-engineer
CI/CD config	`Glob("*/.github/workflows/.yml")`	CI exists, context for faion-cicd-engineer
SDD docs	`Glob("**/.aidocs/constitution.md")`	SDD project, can read spec/design

Discovery Questions

Use AskUserQuestion if intent is unclear after auto-investigation.

Q1: Primary Intent (required if unclear)

yaml

question: "What do you need help with?"
header: "Intent"
multiSelect: false
options:
  - label: "Research & Discovery"
    description: "Ideas, market research, competitors, validation"
  - label: "Planning & Strategy"
    description: "Product roadmap, architecture, project planning"
  - label: "Build & Implement"
    description: "Write code, create designs, develop features"
  - label: "Launch & Market"
    description: "GTM, marketing, SEO, ads, content"
  - label: "Fix & Improve"
    description: "Bug fixes, refactoring, optimization, tests"

Routing:

•"Research & Discovery" → Skill(faion-researcher)
•"Planning & Strategy" → Ask Q1b (Planning type)
•"Build & Implement" → Ask Q1c (Build type) or auto-detect from project
•"Launch & Market" → Skill(faion-marketing-manager)
•"Fix & Improve" → Auto-detect stack, then route to dev skill

Q1b: Planning Type (if "Planning & Strategy")

yaml

question: "What kind of planning?"
header: "Planning"
multiSelect: false
options:
  - label: "Product scope & roadmap"
    description: "MVP definition, features, priorities"
  - label: "Technical architecture"
    description: "System design, tech stack, APIs"
  - label: "Project schedule & resources"
    description: "Timeline, team, milestones"
  - label: "Business requirements"
    description: "Use cases, processes, stakeholders"

Routing:

•"Product scope & roadmap" → Skill(faion-product-manager)
•"Technical architecture" → Skill(faion-software-architect)
•"Project schedule & resources" → Skill(faion-project-manager)
•"Business requirements" → Skill(faion-business-analyst)

Q1c: Build Type (if "Build & Implement" and no auto-detect)

yaml

question: "What are you building?"
header: "Build"
multiSelect: false
options:
  - label: "Backend / API"
    description: "Server-side code, database, APIs"
  - label: "Frontend / UI"
    description: "User interface, components, styling"
  - label: "Full-stack feature"
    description: "Both frontend and backend"
  - label: "Infrastructure / DevOps"
    description: "Deployment, CI/CD, containers"
  - label: "AI / ML feature"
    description: "LLM integration, RAG, agents"

Routing:

•"Backend / API" → Detect stack or ask, then route
•"Frontend / UI" → Skill(faion-frontend-developer) or Skill(faion-javascript-developer)
•"Full-stack feature" → Detect stack, coordinate skills
•"Infrastructure / DevOps" → Skill(faion-devops-engineer)
•"AI / ML feature" → Skill(faion-ml-engineer)

Q2: Project Stage (context for methodology depth)

yaml

question: "What stage is your project at?"
header: "Stage"
multiSelect: false
options:
  - label: "Idea phase"
    description: "Exploring, not committed yet"
  - label: "Planning phase"
    description: "Defining scope, architecture"
  - label: "Active development"
    description: "Building features"
  - label: "Pre-launch"
    description: "Preparing for release"
  - label: "Live product"
    description: "Has users, iterating"

Context impact:

•"Idea phase" → Research-heavy, validation methodologies
•"Planning phase" → Architecture, specs, design docs
•"Active development" → Implementation patterns, testing
•"Pre-launch" → QA, performance, launch prep
•"Live product" → Monitoring, optimization, growth

Q3: Primary Concerns (optional, multiSelect)

yaml

question: "What are your main concerns for this task?"
header: "Concerns"
multiSelect: true
options:
  - label: "Speed of delivery"
    description: "Ship fast, iterate later"
  - label: "Code quality"
    description: "Clean, maintainable, tested"
  - label: "Performance"
    description: "Fast, scalable, efficient"
  - label: "Security"
    description: "Protect data, prevent attacks"

Context impact:

•"Speed of delivery" → Pragmatic patterns, skip optional steps
•"Code quality" → Full testing, code review, documentation
•"Performance" → Optimization methodologies, profiling
•"Security" → Security testing, auth patterns, OWASP

Decision Tree

What does the user want?

code

RESEARCH & STRATEGY
├── Market research, TAM/SAM, competitors → Skill(faion-researcher)
├── System design, architecture, ADRs → Skill(faion-software-architect)
└── Product planning, MVP, roadmaps → Skill(faion-product-manager)

DEVELOPMENT
├── Python (Django, FastAPI) → Skill(faion-python-developer)
├── JavaScript (React, Node, Next.js) → Skill(faion-javascript-developer)
├── Go, Rust, databases, caching → Skill(faion-backend-systems)
├── Java, C#, PHP, Ruby → Skill(faion-backend-enterprise)
├── Frontend (Tailwind, PWA, a11y) → Skill(faion-frontend-developer)
├── APIs (REST, GraphQL, OpenAPI) → Skill(faion-api-developer)
├── Testing (TDD, E2E, mocking) → Skill(faion-testing-developer)
├── Code quality, refactoring, DDD → Skill(faion-code-quality)
└── Automation, Puppeteer, monorepo → Skill(faion-automation-tooling)

INFRASTRUCTURE & DEVOPS
├── Docker, K8s, Terraform, AWS/GCP → Skill(faion-infrastructure-engineer)
└── CI/CD, GitHub Actions, GitOps → Skill(faion-cicd-engineer)

AI & MACHINE LEARNING
├── LLM APIs (OpenAI, Claude, Gemini) → Skill(faion-llm-integration)
├── RAG, embeddings, vector DBs → Skill(faion-rag-engineer)
├── Fine-tuning, evaluation, ML Ops → Skill(faion-ml-ops)
├── AI agents, LangChain, MCP → Skill(faion-ai-agents)
└── Vision, image/video gen, TTS/STT → Skill(faion-multimodal-ai)

MARKETING
├── GTM, launches, positioning, pricing → Skill(faion-gtm-strategist)
├── Content, SEO copywriting, email → Skill(faion-content-marketer)
├── Growth, AARRR, A/B testing → Skill(faion-growth-marketer)
├── Landing pages, CRO, funnels → Skill(faion-conversion-optimizer)
├── Google/Meta/LinkedIn Ads → Skill(faion-ppc-manager)
├── Technical SEO, link building → Skill(faion-seo-manager)
└── Social media, community → Skill(faion-smm-manager)

PROJECT & BUSINESS
├── Scrum, Kanban, Jira/Linear → Skill(faion-pm-agile)
├── PMBoK, WBS, EVM → Skill(faion-pm-traditional)
├── Requirements, elicitation, strategy → Skill(faion-ba-core)
└── Use cases, BPMN, data models → Skill(faion-ba-modeling)

DESIGN & UX
├── User research, usability testing → Skill(faion-ux-researcher)
├── Wireframes, design systems, Figma → Skill(faion-ui-designer)
└── WCAG, accessibility, a11y → Skill(faion-accessibility-specialist)

SDD WORKFLOW
├── Specs, design docs, impl-plans → Skill(faion-sdd-planning)
├── Quality gates, code review → Skill(faion-sdd-execution)
└── Sequential task execution → Skill(faion-feature-executor)

COMMUNICATION & HR
├── Stakeholder dialogue, Mom Test → Skill(faion-communicator)
└── Recruiting, interviews, onboarding → Skill(faion-hr-recruiter)

CLAUDE CODE
└── Skills, hooks, MCP servers, IDE → Skill(faion-claude-code)

Quick Reference

Domain	Primary Skill	Methodologies
Research	`faion-researcher`	40
Architecture	`faion-software-architect`	31
Product	`faion-product-manager`	69
Development	`faion-software-developer`	138
DevOps	`faion-devops-engineer`	87
AI/ML	`faion-ml-engineer`	140
Marketing	`faion-marketing-manager`	135
Project Mgmt	`faion-project-manager`	97
Business Analysis	`faion-business-analyst`	55
UX/UI	`faion-ux-ui-designer`	179
SDD	`faion-sdd`	71

Routing Examples

Research:

code

"Analyze competitors" → Skill(faion-researcher)
"Design system architecture" → Skill(faion-software-architect)

Development:

code

"Build Django API" → Skill(faion-python-developer)
"Create React component" → Skill(faion-javascript-developer)
"Write unit tests" → Skill(faion-testing-developer)

AI/ML:

code

"Integrate OpenAI API" → Skill(faion-llm-integration)
"Build RAG pipeline" → Skill(faion-rag-engineer)
"Create AI agent" → Skill(faion-ai-agents)

Marketing:

code

"Plan product launch" → Skill(faion-gtm-strategist)
"Optimize landing page" → Skill(faion-conversion-optimizer)
"Run Google Ads" → Skill(faion-ppc-manager)

Multi-domain (sequential):

code

"Validate and build my SaaS idea"
→ 1. Skill(faion-researcher) - validate
→ 2. Skill(faion-product-manager) - plan MVP
→ 3. Skill(faion-software-architect) - design
→ 4. Skill(faion-software-developer) - build

Statistics

Metric	Count
Skills	54
Orchestrators	3
Leaf skills	51
Methodologies	1297

Methodology Structure

Each methodology is a folder with 5 files:

code

{methodology}/
├── README.md       # Main content
├── checklist.md    # Step-by-step checklist
├── templates.md    # Code/config templates
├── examples.md     # Practical examples
└── llm-prompts.md  # AI prompts

Faion Network v3.0