📦 deps(thirdparty): update snapshots
This commit is contained in:
@@ -0,0 +1,160 @@
|
||||
# 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
|
||||
|
||||
```bash
|
||||
# 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
|
||||
Reference in New Issue
Block a user