name: framework-factory description: Scaffold complete agentic frameworks for new work domains following proven patterns from Jira, Gmail, KB, GitHub, and Todo. Use when adding a new area of work that needs orchestrator, subagents, commands, skills, and MCP integration. Generates production-ready framework in minutes.

Framework Factory

Generate complete agentic frameworks for new work domains using the proven architectural pattern from Jira, Gmail, KB, GitHub, and Todo.

Quick Start

/framework-factory "calendar"

What Gets Generated

For a domain like "calendar":

~/.claude/agents/
├── calendar-orchestrator.md    # Pure router (Sonnet)
├── calendar-creator.md         # Event creation (Haiku)
├── calendar-operator.md        # Updates/deletes (Sonnet)
├── calendar-searcher.md        # Queries (Haiku)
└── calendar-scheduler.md       # Scheduling logic (Sonnet)

~/.claude/skills/calendar-pro/
└── SKILL.md                    # User documentation

~/.claude/commands/
├── calendar.sync.md
├── calendar.add.md
├── calendar.search.md
└── calendar.schedule.md

~/.claude/resources/calendar/
└── README.md                   # Resource structure

# If MCP needed (via mcp-skill-creator):
~/.claude/mcp-servers/calendar-mcp/
├── src/index.ts
├── package.json
└── README.md

The Pattern

All domains follow an identical architecture:

Domain: [name]
├── 1 Orchestrator Agent (Sonnet, pure router, NO MCP tools)
│   └── Routes requests to N specialized subagents
├── 4-7 Specialized Subagents
│   ├── Creator (Haiku) - Fast creation operations
│   ├── Operator (Sonnet) - Safety-critical writes/deletes
│   ├── Searcher/Analytics (Haiku) - Fast read-only queries
│   ├── Manager (Sonnet) - Lifecycle management
│   └── [Domain-specific specialists]
├── 1 Skill (SKILL.md with YAML frontmatter)
│   └── User documentation, preferences, quick reference
├── N Commands (slash commands with YAML frontmatter)
│   └── Each delegates to orchestrator with specific mode
├── Resources Directory (optional)
│   └── Templates, query libraries, best practices
└── MCP Server Integration (if external API)

Model Selection Pattern

| Agent Type | Model | Rationale | |------------|-------|-----------| | Orchestrator | Sonnet | Routing decisions need balance | | Creator | Haiku | Fast, cheap creation | | Bulk Operator | Sonnet | Safety-critical writes | | Searcher/Analytics | Haiku | Fast reads | | Strategic Planner | Opus | Expensive, use sparingly |

Tool Access Pattern

| Agent Type | Tools | Rationale | |------------|-------|-----------| | Orchestrator | Read, Task only | Pure router, NO MCP tools | | Creator | MCP create tools, Read, Bash | Creation operations | | Operator | MCP update/delete, Read, Bash | Write operations need safety | | Searcher | MCP search/get, Read | Read-only queries | | Manager | Full MCP access | Lifecycle management |

Write Approval Pattern

All write agents MUST request approval before:

• Creating new items
• Updating existing items
• Deleting items
• Moving items between states

Interactive Workflow

Step 1: Domain Analysis

Q1: What domain are you creating?
    Example: calendar, crm, inventory, project-tracker

Q2: What external system does this domain integrate with?
    Example: Google Calendar, Salesforce, none (local only)
    → If external: delegate to mcp-skill-creator

Q3: Brief description of what this domain manages?
    Example: "Events, reminders, and scheduling across calendars"

Step 2: Operation Selection

Which operations does this domain support?
  [x] Create/Add new items          → Generates creator agent
  [x] Update/Modify items           → Generates operator agent
  [x] Delete items                  → Added to operator agent
  [x] Search/Query                  → Generates searcher agent
  [ ] Analytics/Metrics             → Generates analytics agent
  [x] Scheduling/Lifecycle          → Generates scheduler/manager agent
  [x] Sync with external system     → Generates sync command

Step 3: Generate Framework

Generating framework for: calendar

Files to create:
  Agents (5):
    - calendar-orchestrator.md
    - calendar-creator.md
    - calendar-operator.md
    - calendar-searcher.md
    - calendar-scheduler.md

  Skill (1):
    - skills/calendar-pro/SKILL.md

  Commands (4):
    - calendar.sync.md
    - calendar.add.md
    - calendar.search.md
    - calendar.schedule.md

Proceed? [y/n]

Step 4: Documentation

• Adds new domain to CLAUDE.md MCP delegation table
• Updates KB with new domain patterns
• Generates usage examples

Skill Delegations

| Task | Delegate To | When | |------|-------------|------| | MCP server scaffolding | mcp-skill-creator | External API integration needed | | SKILL.md validation | skill-creator | After skill file generated | | Agent structure validation | agent-factory | After agents generated | | KB documentation | kb-pro | Document new domain patterns |

Existing Domain Examples

Jira Domain (6 agents)

• jira-orchestrator → jira-ticket-creator, jira-bulk-operator, jira-analytics, jira-sprint-manager, jira-strategist

Gmail Domain (7 agents)

• gmail-orchestrator → gmail-sync-operator, gmail-search-analyst, gmail-message-operator, gmail-triage-assistant, gmail-analytics, gmail-briefing-generator

KB Domain (7 agents)

• kb-orchestrator → kb-ingestor, kb-distiller, kb-searcher, kb-writer, kb-indexer, kb-reviewer

GitHub Domain (7 agents)

• github-orchestrator → github-pr-manager, github-issue-operator, github-review-operator, github-repo-operator, github-search-analyst, github-security-monitor

Todo Domain (4 agents)

• todo-orchestrator → todo-writer, todo-triage, todo-auditor

Template Variables

| Variable | Example | Description | |----------|---------|-------------| | {{domain}} | calendar | Lowercase domain name | | {{domain_title}} | Calendar | Title case for headings | | {{domain_description}} | Events and scheduling | Brief description | | {{mcp_server}} | mcp__calendar__ | MCP tool prefix | | {{operations}} | ["create", "search"] | Selected operations |

Usage Examples

Basic Domain (No MCP)

/framework-factory "task-tracker"
# → Local-only task tracking
# → No MCP server generated

Domain with External API

/framework-factory "calendar"
# Q: External system? → Google Calendar
# → Delegates to mcp-skill-creator
# → Full MCP server scaffolded

Minimal Domain

/framework-factory "notes" --operations "create,search"
# → Only creator and searcher agents
# → Minimal command set

Success Criteria

1. New domain scaffolded in <2 minutes
2. All files have correct YAML frontmatter
3. Follows exact pattern of existing 5 domains
4. Ready for customization after generation
5. Includes TODO comments for domain-specific additions

Related Skills

• agent-factory - Individual agent creation
• skill-creator - Skill file structure
• hook-factory - Event hook generation
• mcp-skill-creator - MCP server scaffolding
• kb-pro - Knowledge base management

References

• See PATTERN.md for detailed architectural documentation
• See templates/ for all template files
• See existing domains in ~/.claude/agents/ for live examples