playbook/outfitter-agents/MIGRATION.md

Migration Guide

This document tracks plugin and skill renames to help update external references.

Plugin Renames

Old Name	New Name	Notes
baselayer	outfitter	Core methodology plugin
agent-kit	(merged into outfitter)	Skills, agents, templates now in outfitter
gitbutler	but	Matches CLI command
graphite	gt	Matches CLI command
vcs	(deleted)	Split into but + gt; multi-agent-vcs moved to outfitter

Install Commands

# Old
/plugin install baselayer@outfitter
/plugin install gitbutler@outfitter
/plugin install vcs@outfitter

# New
/plugin install outfitter@outfitter
/plugin install but@outfitter
/plugin install gt@outfitter

Skill Prefix Changes

All skill invocations using the old prefixes need updating:

Old	New
baselayer:*	outfitter:*
agent-kit:*	outfitter:*
vcs:*	(see skill mapping below)

Skill Path Mapping

baselayer → outfitter

Skills moved and renamed to shorter forms. Prefix changes from baselayer: to outfitter:.

Old Skill Reference	New Skill Reference
baselayer:debugging-and-diagnosis	outfitter:debugging
baselayer:test-driven-development	outfitter:tdd
baselayer:use-the-best-tool	outfitter:which-tool
baselayer:research-and-report	outfitter:research
baselayer:root-cause-analysis	outfitter:find-root-causes
baselayer:software-architecture	outfitter:architecture
baselayer:software-engineering	outfitter:software-craft
baselayer:security-engineering	outfitter:security
baselayer:performance-engineering	outfitter:performance
baselayer:complexity-analysis	outfitter:simplify
baselayer:pattern-analysis	outfitter:patterns
baselayer:scenario-testing	outfitter:scenarios
baselayer:subagent-coordination	outfitter:subagents
baselayer:status-reporting	outfitter:check-status
baselayer:codebase-analysis	outfitter:codebase-recon
baselayer:conversation-analysis	outfitter:session-analysis
baselayer:cli-development-guidelines	outfitter:cli-dev
baselayer:pathfinding	outfitter:pathfinding
baselayer:code-review	outfitter:code-review
baselayer:patternify	outfitter:codify
baselayer:context-management	outfitter:context-management
(all other baselayer skills)	(same pattern)

agent-kit → outfitter (merged + renamed)

Skills were merged into outfitter and renamed to shorter forms:

Old Skill Reference	New Skill Reference
agent-kit:skills-development	outfitter:skills-dev
agent-kit:claude-plugin-development	outfitter:claude-plugins
agent-kit:claude-agent-development	outfitter:claude-agents
agent-kit:claude-hook-authoring	outfitter:claude-hooks
agent-kit:claude-command-authoring	outfitter:claude-commands
agent-kit:claude-rules-authoring	outfitter:claude-rules
agent-kit:claude-code-configuration	outfitter:claude-config
agent-kit:codex-configuration	outfitter:codex-config

Skill restructured:

Old	New
outfitter:claude-skills	Merged into outfitter:skills-dev as references/claude-code.md

Claude-specific guidance (tool restrictions, testing, troubleshooting) is now in skills-dev/references/claude-code.md rather than a separate skill.

Agent moved:

Old	New
agent-kit:agent-expert	outfitter:quartermaster

vcs → but / gt / outfitter

Old Path	New Path	New Reference
vcs/skills/gitbutler-virtual-branches/	but/skills/virtual-branches/	but:virtual-branches
vcs/skills/gitbutler-multi-agent/	but/skills/multi-agent/	but:multi-agent
vcs/skills/gitbutler-stacks/	but/skills/stacks/	but:stacks
vcs/skills/gitbutler-complete-branch/	but/skills/complete-branch/	but:complete-branch
vcs/skills/graphite-stacks/	gt/skills/stacks/	gt:stacks
vcs/skills/multi-agent-vcs/	outfitter/skills/multi-agent-vcs/	outfitter:multi-agent-vcs

gitbutler (old standalone) → but

Old Path	New Path
gitbutler/skills/version-control/	but/skills/virtual-branches/
gitbutler/skills/multi-agent/	but/skills/multi-agent/
gitbutler/skills/stack-workflows/	but/skills/stacks/
gitbutler/skills/complete-branch/	but/skills/complete-branch/

Agent Mapping

Old Reference	New Reference
baselayer:senior-dev	outfitter:engineer
baselayer:ranger	outfitter:reviewer
baselayer:analyst	outfitter:analyst
baselayer:debugger	outfitter:debugger
baselayer:tester	outfitter:tester
baselayer:skeptic	outfitter:skeptic
baselayer:specialist	outfitter:specialist
baselayer:scout	outfitter:scout
baselayer:librarian	outfitter:librarian
baselayer:pattern-analyzer	outfitter:analyst
vcs:gitbutler-expert	but:gitbutler-expert

Agent Renames (outfitter 1.0)

Old Name	New Name
senior-dev	engineer
ranger	reviewer

Command Mapping

Old Command	New Command
/baselayer:debug	/outfitter:debug
/baselayer:tdd	(removed — use outfitter:tdd skill directly)
/baselayer:pathfind	/outfitter:collab
/baselayer:simplify	/outfitter:simplify
/baselayer:patternify	/outfitter:codify
/baselayer:sitrep	/outfitter:sitrep
/baselayer:best-tool	/outfitter:toolcheck
/baselayer:dispatch-agents	/outfitter:crew:dispatch

Command Renames (outfitter 1.0)

Old Name	New Name
best-tool	toolcheck
dispatch-agents	crew:dispatch
pathfind	collab
tdd	(removed)

Directory Structure

Before

agents/
├── baselayer/           # Core methodology
├── gitbutler/           # GitButler (standalone, old)
├── vcs/                 # Unified VCS (GitButler + Graphite + multi-agent)
├── agent-kit/
└── cli-dev/

After

agents/
├── outfitter/           # Core methodology + extensibility skills (merged from agent-kit)
├── but/                 # GitButler workflows
├── gt/                  # Graphite workflows
└── cli-dev/

Search & Replace Patterns

For bulk updates in external codebases:

# Plugin names
s/baselayer/outfitter/g
s/\bagent-kit\b/outfitter/g
s/\bgitbutler\b/but/g      # word boundary to avoid partial matches
s/\bgraphite\b/gt/g

# Skill prefixes
s/baselayer:/outfitter:/g
s/agent-kit:/outfitter:/g
s/vcs:gitbutler-/but:/g
s/vcs:graphite-/gt:/g
s/vcs:multi-agent-vcs/outfitter:multi-agent-vcs/g

# Skill renames (agent-kit → outfitter)
s/skills-development/skills-dev/g
s/claude-plugin-development/claude-plugins/g
s/claude-agent-development/claude-agents/g
s/claude-hook-authoring/claude-hooks/g
s/claude-command-authoring/claude-commands/g
s/claude-rules-authoring/claude-rules/g
s/claude-code-configuration/claude-config/g
s/codex-configuration/codex-config/g

# Skill renames (baselayer/outfitter shorter names)
s/debugging-and-diagnosis/debugging/g
s/test-driven-development/tdd/g
s/use-the-best-tool/which-tool/g
s/research-and-report/research/g
s/root-cause-analysis/find-root-causes/g
s/software-architecture/architecture/g
s/software-engineering/software-craft/g
s/security-engineering/security/g
s/performance-engineering/performance/g
s/complexity-analysis/simplify/g
s/pattern-analysis/patterns/g
s/scenario-testing/scenarios/g
s/subagent-coordination/subagents/g
s/status-reporting/check-status/g
s/codebase-analysis/codebase-recon/g
s/conversation-analysis/session-analysis/g
s/cli-development-guidelines/cli-dev/g

Skill Name Shortening (outfitter)

All verbose skill names shortened for cleaner invocations:

Old Name	New Name
debugging-and-diagnosis	debugging
test-driven-development	tdd
use-the-best-tool	which-tool
research-and-report	research
root-cause-analysis	find-root-causes
software-architecture	architecture
software-engineering	software-craft
security-engineering	security
performance-engineering	performance
complexity-analysis	simplify
pattern-analysis	patterns
scenario-testing	scenarios
subagent-coordination	subagents
status-reporting	check-status
codebase-analysis	codebase-recon
conversation-analysis	session-analysis
cli-development-guidelines	cli-dev

Completed Migrations

• baselayer → outfitter (core methodology)
• agent-kit → merged into outfitter (skills, agents, templates)
• vcs → split into but + gt
• Skill naming convention overhaul (shorter names)

Pending Changes

Document future migrations here before executing them.

(none pending)