playbook/outfitter-agents/.agents/notes/202511281355-consolidation-...

4.9 KiB

Consolidation from Agentish to Outfitter

Date: 2025-11-28 Context: Migration and consolidation of Claude Code plugin development ecosystem

Background

The agentish repo (galligan/agentish) was originally being built as a Claude Code marketplace for agent-driven development. During planning, we discovered:

  1. Anthropic's official plugin-dev plugin (from claude-code-plugins marketplace) already provides comprehensive creation capabilities:

    • 7 skills for creating plugins, skills, commands, hooks, agents
    • 3 specialized agents
    • Well-documented and maintained
  2. Existing outfitter-dev/agents repo already had a claude-dev plugin with 13 skills covering both creation and validation

  3. No plugin dependency system exists in Claude Code - plugins are independent

Decision: Consolidate into Outfitter

Rather than duplicate Anthropic's work or maintain two repos, we consolidated everything into outfitter-dev/agents with clear separation of concerns:

Ecosystem Architecture

Creating plugins/skills/etc:  Anthropic's plugin-dev (claude-code-plugins)
Validating components:        claude-dev@outfitter
General utilities:            outfitter@outfitter

Changes Made

1. Created outfitter Plugin

New plugin for general-purpose development utilities:

outfitter/
├── .claude-plugin/plugin.json
├── commands/
│   └── jam.md                    # /outfitter:jam command
└── skills/
    └── jam/
        ├── SKILL.md              # Full skill (migrated from brainstorm)
        ├── references/
        │   ├── confidence.md     # Confidence interval deep-dive
        │   └── questions.md      # Question crafting guidance
        └── examples/
            └── auth-system.md    # Example session

Jam is an adaptive Q&A workflow with confidence tracking:

  • Asks one question at a time with 2-4 options
  • Tracks confidence using emoji intervals (🚫🔴🟡🟢)
  • Delivers solution at 🟢 High confidence (≥86%)
  • Includes structured reflection after each answer

2. Trimmed claude-dev Plugin

Removed creation-focused skills (Anthropic's plugin-dev covers these):

  • create-claude-command
  • create-claude-hook
  • create-claude-plugin
  • create-claude-skill
  • create-claude-subagent
  • distribute-claude-plugin

Kept validation and config management:

  • validate-claude-plugin
  • validate-claude-command
  • validate-claude-hook
  • validate-claude-skill
  • validate-claude-subagent
  • setup-plugin-marketplace
  • manage-claude-config

Updated README to:

  • Focus on validation and config management
  • Recommend Anthropic's plugin-dev for creation
  • Document the complementary relationship

3. Updated Marketplace

marketplace.json now includes:

  • outfitter - General utilities (jam, etc.)
  • claude-dev - Validation and config management
  • blz - Documentation search (external source)

4. Deprecated Agentish

Updated agentish repo README and CLAUDE.md:

  • Clear deprecation notice
  • Redirect to outfitter-dev/agents
  • Installation instructions for new location

Installation Instructions

# Add Outfitter marketplace
/plugin marketplace add outfitter-dev/agents

# Install plugins
/plugin install outfitter@outfitter
/plugin install claude-dev@outfitter

# For creating plugins (Anthropic's official)
/plugin marketplace add anthropics/claude-code-plugins
/plugin install plugin-dev@claude-code-plugins

Key Concepts

Jam Skill

Confidence intervals:

  • 🚫 Unknown (0-59): Major gaps, foundational questions needed
  • 🔴 Low (60-75): Significant uncertainty, key decisions pending
  • 🟡 Medium (76-85): Reasonable clarity, minor gaps remain
  • 🟢 High (86-100): Ready to deliver

Workflow:

  1. Ask exactly one question with 2-4 options
  2. User responds (number, modification, or clarification)
  3. Restate understanding + update confidence
  4. Repeat until 🟢 or user requests delivery

Plugin Naming

When installed, commands get namespace prefixes:

  • /outfitter:jam - Jam session command
  • /claude-dev:validate:skill - Skill validation (if nested)

Files Modified/Created

Created:

  • /outfitter/.claude-plugin/plugin.json
  • /outfitter/commands/jam.md
  • /outfitter/skills/jam/SKILL.md
  • /outfitter/skills/jam/references/confidence.md
  • /outfitter/skills/jam/references/questions.md
  • /outfitter/skills/jam/examples/auth-system.md

Modified:

  • /.claude-plugin/marketplace.json
  • /claude-dev/README.md

Deleted (from claude-dev/skills/):

  • create-claude-command/
  • create-claude-hook/
  • create-claude-plugin/
  • create-claude-skill/
  • create-claude-subagent/
  • distribute-claude-plugin/

Future Considerations

  • The jam skill could be enhanced with more examples
  • Consider adding more general utilities to the outfitter plugin
  • May want to add CI/validation scripts to the repo
  • Could explore whether blz should be brought in-tree or kept as external reference