Skip to content

Commit cfe6a85

Browse files
committed
refactor(bugfix): migrate commands to skills-only architecture
Commands in Claude Code are now unified with skills. The eight thin stub commands that just dispatched to the controller were pure boilerplate, and speedrun was the only command with real logic. - Delete .claude/commands/ directory (9 files) - Convert speedrun command to .claude/skills/speedrun/SKILL.md - Add Dispatch section to each phase skill so it reads the controller when invoked directly (not via controller or speedrun) - Update return-path references from commands/speedrun to skills/speedrun - Trim ambient.json: remove unused greeting field, simplify systemPrompt - Update README, CLAUDE.md, and WORKFLOW_DEVELOPMENT_GUIDE examples Made-with: Cursor
1 parent 40ca47f commit cfe6a85

22 files changed

Lines changed: 97 additions & 98 deletions

File tree

WORKFLOW_DEVELOPMENT_GUIDE.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -339,11 +339,8 @@ git checkout -b feature/bugfix-improvements
339339
# Edit the workflow configuration
340340
vim workflows/bugfix/.ambient/ambient.json
341341

342-
# Add or modify a command
343-
vim workflows/bugfix/.claude/commands/diagnose.md
344-
345342
# Add or modify a skill
346-
vim workflows/bugfix/.claude/skills/root-cause-analysis/SKILL.md
343+
vim workflows/bugfix/.claude/skills/diagnose/SKILL.md
347344

348345
# Edit persistent context
349346
vim workflows/bugfix/CLAUDE.md
@@ -492,8 +489,8 @@ Claude can sometimes mix these up, especially when:
492489
**1. Use explicit paths:**
493490

494491
```text
495-
❌ "Create a new command for the diagnose phase"
496-
✅ "Create a new command at workflows/bugfix/.claude/commands/diagnose.md"
492+
❌ "Create a new skill for the diagnose phase"
493+
✅ "Create a new skill at workflows/bugfix/.claude/skills/diagnose/SKILL.md"
497494
```
498495

499496
**2. Be explicit about context:**
Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
{
22
"name": "Fix a bug",
33
"description": "Systematic workflow for analyzing, fixing, and verifying software bugs with comprehensive testing and documentation. Guides you through reproduction, root cause diagnosis, fix implementation, testing, and documentation.",
4-
"systemPrompt": "You are Amber, the Ambient Code Platform's expert colleague for systematic bug resolution.\n\nYou are controlled by a workflow controller at:\n .claude/skills/controller/SKILL.md\n\nRead it at the start of the session. It defines how to execute phases, recommend next steps, and handle transitions.\n\nWorkspace layout:\n- Controller: .claude/skills/controller/SKILL.md\n- Phase skills: .claude/skills/{name}/SKILL.md\n- Commands: .claude/commands/*.md\n- Artifacts: artifacts/bugfix/",
5-
"startupPrompt": "Greet the user as Amber, their bug fix assistant. Explain that you'll guide them through systematic bug resolution: assess the report, reproduce the bug, diagnose root cause, implement the fix, test it, and document everything. Ask them to describe the bug or paste a bug report or issue URL to get started.",
6-
"greeting": "Welcome to the Bug Fix workflow! I'm Amber, and I'll guide you through systematic bug resolution.\n\nPhases:\n1. Assess — Understand the bug report and propose a plan\n2. Reproduce — Confirm the bug is reproducible\n3. Diagnose — Identify the root cause\n4. Fix — Implement the solution\n5. Test — Verify the fix and add regression tests\n6. Document — Create documentation and optionally a PR\n\nTo get started, describe the bug or paste a bug report or issue URL."
4+
"systemPrompt": "You are Amber, an expert colleague for systematic bug resolution.\n\nAt the start of the session, read .claude/skills/controller/SKILL.md — it defines the workflow phases, how to execute them, and how to recommend next steps.",
5+
"startupPrompt": "Greet the user as Amber, their bug fix assistant. Explain that you'll guide them through systematic bug resolution: assess the report, reproduce the bug, diagnose root cause, implement the fix, test it, and document everything. Ask them to describe the bug or paste a bug report or issue URL to get started."
76
}

workflows/bugfix/.claude/commands/assess.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

workflows/bugfix/.claude/commands/diagnose.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

workflows/bugfix/.claude/commands/document.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

workflows/bugfix/.claude/commands/fix.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

workflows/bugfix/.claude/commands/pr.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

workflows/bugfix/.claude/commands/reproduce.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

workflows/bugfix/.claude/commands/review.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

workflows/bugfix/.claude/commands/test.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

0 commit comments

Comments
 (0)