Framework Factory - Claude Code Skill

Scaffold complete agentic frameworks for new work domains in minutes using proven architectural patterns from Jira, Gmail, KB, GitHub, and Todo.

What This Skill Does

Generates production-ready agentic frameworks with:

• Orchestrator agent - Pure router (Sonnet) that delegates to specialists
• 4-7 specialized subagents - Creators (Haiku), Operators (Sonnet), Searchers (Haiku), Managers
• User-facing skill - Documentation and preferences
• Slash commands - Domain-specific commands
• Resource directory - Templates and best practices
• MCP server integration - Optional external API integration

Quick Install

cd ~/.claude/skills/
git clone https://github.com/goforit5/framework-factory

See INSTALL.md for detailed installation instructions.

Usage

/framework-factory "calendar"

The skill will:

1. Ask about your domain (name, external system, description)
2. Select operations (create, update, delete, search, analytics, scheduling)
3. Generate complete framework with agents, skill, commands, and resources
4. Update documentation and KB

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

Proven Pattern

All generated frameworks follow the same architecture:

Model Selection

• Orchestrator: Sonnet (routing decisions)
• Creator: Haiku (fast, cheap creation)
• Operator: Sonnet (safety-critical writes)
• Searcher: Haiku (fast reads)
• Strategist: Opus (expensive, use sparingly)

Tool Access

• Orchestrator: Read, Task only (NO MCP tools)
• Creator: MCP create tools, Read, Bash
• Operator: MCP update/delete, Read, Bash
• Searcher: MCP search/get, Read (read-only)
• Manager: Full MCP access

Write Approval

All write agents MUST request approval before:

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

Existing Domain Examples

• Jira (6 agents): Orchestrator → ticket-creator, bulk-operator, analytics, sprint-manager, strategist
• Gmail (7 agents): Orchestrator → sync-operator, search-analyst, message-operator, triage-assistant, analytics, briefing-generator
• KB (7 agents): Orchestrator → ingestor, distiller, searcher, writer, indexer, reviewer
• GitHub (7 agents): Orchestrator → pr-manager, issue-operator, review-operator, repo-operator, search-analyst, security-monitor
• Todo (4 agents): Orchestrator → writer, triage, auditor

Package Contents

• SKILL.md - Main skill definition with full workflow
• PATTERN.md - Architectural pattern documentation
• templates/ - Agent and command templates:
  • orchestrator.md.tmpl
  • agent-creator.md.tmpl
  • agent-operator.md.tmpl
  • agent-searcher.md.tmpl
  • agent-manager.md.tmpl
  • agent-analytics.md.tmpl
  • skill.md.tmpl
  • command.md.tmpl
  • resources-readme.md.tmpl

Requirements

• Claude Code CLI
• Active Claude account
• Existing agents, skills, and commands directories (skill will create if missing)

Use Cases

• New API integration: Scaffold framework for Salesforce, Stripe, Twilio, etc.
• Internal tools: Task trackers, inventory systems, project management
• Data pipelines: ETL workflows, data synchronization
• Content management: Blog systems, documentation portals
• Business domains: CRM, accounting, HR systems

Integration with Other Skills

Delegates to:

• mcp-skill-creator: MCP server scaffolding (if external API)
• skill-creator: SKILL.md validation
• agent-factory: Agent structure validation
• kb-pro: Document new domain patterns

---

Version 1.0.0 | Created by Andrew Maddock