framework-dev

Framework Developer Orchestrator v4.0.0

A Claude Code plugin that helps you plan and finalize software project frameworks through structured discussion, research-backed recommendations, engineering rigor, and multi-agent coordination.

What's New in v4.0.0

• Premise Challenge - Validates the "why" before building the "what"
• 4 Scope Modes - Expansion, Selective, Hold, Reduction — choose your planning posture
• Implementation Alternatives - 2-3 approaches evaluated before committing (mandatory)
• Dream State Mapping - Current → Plan → 12-month ideal trajectory
• 0-10 Rating Method - Rate, identify gap, fix, re-rate for every dimension
• Scope Challenge - Complexity check, search check, completeness check, distribution check
• Outside Voice - Independent AI second opinion via subagent
• Confidence Scoring - Every finding scored 1-10 with calibrated display rules
• Interactive Review - One issue per AskUserQuestion, STOP between sections
• ASCII Coverage Diagrams - Visual test coverage mapping with gap analysis
• Review Report - Standardized findings summary with deferred items
• Autoplan Command - /autoplan for fully auto-reviewed plans via 6 decision principles
• Prime Directives - 9 non-negotiable engineering principles
• Cognitive Patterns - 17 thinking instincts from CEO, engineering, and design disciplines
• New scope-review Skill - Dedicated skill for scope challenge and mode selection

Features

• 6-Phase Structured Workflow - From discovery to integration with engineering rigor
• Research-First Approach - Every recommendation backed by sources with confidence scores
• Multi-Agent Orchestration - Coordinate multiple LLMs for complex projects
• Context Hygiene ("Small Circle") - Prevents context drift in long sessions
• ASCII + Mermaid Diagrams - Auto-generated architecture visualizations
• State Persistence - Save and resume project planning sessions
• Blueprint Generation - Comprehensive project documentation
• Scope Modes - 4 planning postures for different project needs
• Outside Voice - Independent plan challenge from a fresh AI perspective

Installation

Option 1: Via GitHub (Recommended)

Add to your ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "framework-dev": {
      "source": {
        "source": "github",
        "repo": "Ankurjain1121/framework-developer-agent"
      }
    }
  },
  "enabledPlugins": {
    "framework-dev@framework-dev": true
  }
}

Option 2: Local Clone

git clone https://github.com/Ankurjain1121/framework-developer-agent.git ~/.claude/plugins/framework-dev

Option 3: CLI with --plugin-dir

claude --plugin-dir /path/to/framework-developer-agent

Usage

Start a New Project

/framework-dev

Or invoke through natural language:

"Help me plan the framework for my new project"

Commands

Command	Description
/framework-dev	Start the orchestrator for a new or existing project
/autoplan	NEW Auto-review pipeline — rough idea in, fully reviewed plan out
/checkpoint	Force a context refresh and state snapshot
/validate [contracts|links|state|all]	Validate blueprints against implementation
/rollback [list|phase-N|checkpoint-ID]	Rollback to a previous checkpoint
/export [pdf|html|notion|markdown]	Export blueprints to shareable formats

Workflow Phases

Phase	Name	Purpose	Skills Used
1	Discovery	Premise challenge, scope mode, alternatives, dream state, outline	scope-review, research-workflow
2	Structure	Module hierarchy (rated 0-10), interaction states, dependencies	architecture-patterns, architecture-decision-records
3	Planning	Scope challenge, API contracts, coding sequence	scope-review, api-design-principles, openapi-spec-generation
3.5	Outside Voice	Independent AI second opinion on the plan	(Agent subagent)
4	Agents	Research-backed LLM assignments, tailored prompts	llm-capability-matching
5	Execution	Test coverage diagrams, handoffs, quality gates	handoff-protocol, deployment-pipeline-design
6	Integration	Review report, final blueprint, deployment readiness	blueprint-generation, e2e-testing-patterns

Skills