87 lines
3.5 KiB
Markdown
87 lines
3.5 KiB
Markdown
# Stack Plugin Skill Consolidation
|
|
|
|
**Date:** 2026-01-27
|
|
**Scope:** `plugins/stack/`
|
|
|
|
## Summary
|
|
|
|
Consolidated 6 reference skills into 1 `outfitter-stack` skill with 8 references. Updated all workflow skills and agents to reference the new structure.
|
|
|
|
**Before:** 13 skills
|
|
**After:** 8 skills
|
|
|
|
## Rationale
|
|
|
|
The stack plugin had grown to include many granular reference skills for individual packages (`outfitter-cli`, `outfitter-mcp`, `outfitter-logging`, `outfitter-testing`, `outfitter-daemon`) plus the core `stack-patterns` skill. This made the skill table unwieldy and scattered related content across multiple entry points.
|
|
|
|
Consolidating into a single `outfitter-stack` skill with references provides:
|
|
- Single entry point for all Stack pattern documentation
|
|
- Progressive disclosure via references (core patterns first, deep dives on demand)
|
|
- Cleaner skill table in README
|
|
- Unified trigger keywords for discovery
|
|
|
|
## Changes
|
|
|
|
### Created
|
|
|
|
```
|
|
plugins/stack/skills/outfitter-stack/
|
|
├── SKILL.md # Core patterns (from stack-patterns)
|
|
└── references/
|
|
├── handler.md # Handler contract details
|
|
├── errors.md # Error taxonomy details
|
|
├── results.md # Result utilities
|
|
├── cli.md # @outfitter/cli deep dive
|
|
├── mcp.md # @outfitter/mcp deep dive
|
|
├── logging.md # @outfitter/logging deep dive
|
|
├── testing.md # @outfitter/testing deep dive
|
|
└── daemon.md # @outfitter/daemon deep dive
|
|
```
|
|
|
|
### Deleted
|
|
|
|
- `plugins/stack/skills/stack-patterns/`
|
|
- `plugins/stack/skills/outfitter-cli/`
|
|
- `plugins/stack/skills/outfitter-mcp/`
|
|
- `plugins/stack/skills/outfitter-logging/`
|
|
- `plugins/stack/skills/outfitter-testing/`
|
|
- `plugins/stack/skills/outfitter-daemon/`
|
|
|
|
### Updated
|
|
|
|
| File | Changes |
|
|
|------|---------|
|
|
| `stack-implement/SKILL.md` | Related Skills: `stack:stack-patterns` → `stack:outfitter-stack` |
|
|
| `stack-architecture/SKILL.md` | Related Skills: `stack:stack-patterns` → `stack:outfitter-stack` |
|
|
| `stack-review/SKILL.md` | Related Skills: `stack:stack-patterns` → `stack:outfitter-stack` |
|
|
| `stack-debug/SKILL.md` | Related Skills: `stack:stack-patterns` → `stack:outfitter-stack` |
|
|
| `stack-adoption/SKILL.md` | Phase refs + Related Skills updated |
|
|
| `README.md` | Skills table rewritten, agent renamed |
|
|
| `agents/stacker.md` | Skill routing table updated, skills list cleaned |
|
|
|
|
### Agent Rename
|
|
|
|
The agent was renamed from `outfitter` to `stacker`:
|
|
- `agents/outfitter.md` → `agents/stacker.md`
|
|
- Frontmatter `agent:` field updated in all workflow skills
|
|
|
|
## Final Structure
|
|
|
|
```
|
|
plugins/stack/skills/
|
|
├── outfitter-stack/ # Reference skill (consolidated)
|
|
├── stack-adoption/ # Workflow: migrate to stack
|
|
├── stack-architecture/ # Workflow: design handlers
|
|
├── stack-debug/ # Workflow: troubleshoot issues
|
|
├── stack-feedback/ # Workflow: report issues
|
|
├── stack-implement/ # Workflow: TDD implementation
|
|
├── stack-review/ # Workflow: compliance audit
|
|
└── stack-scaffold/ # Workflow: component templates
|
|
```
|
|
|
|
## Verification
|
|
|
|
- `rg "stack:outfitter-cli|stack:outfitter-mcp|stack:outfitter-logging|stack:outfitter-testing|stack:outfitter-daemon|stack:stack-patterns"` returns no matches
|
|
- `outfitter-stack/` contains SKILL.md + 8 reference files
|
|
- All workflow skills updated with correct `agent: stacker` frontmatter
|