playbook/outfitter-agents/.agents/logs/2026-01-27-stack-skill-cons...

3.5 KiB

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-patternsstack:outfitter-stack
stack-architecture/SKILL.md Related Skills: stack:stack-patternsstack:outfitter-stack
stack-review/SKILL.md Related Skills: stack:stack-patternsstack:outfitter-stack
stack-debug/SKILL.md Related Skills: stack:stack-patternsstack: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.mdagents/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