From f86f8aa608d83af3bb0c2e7dad7ca1b963a5570a Mon Sep 17 00:00:00 2001 From: Will2406 Date: Fri, 20 Mar 2026 05:19:23 -0500 Subject: [PATCH] docs(claude-code): clarify skills vs meta-commands in Commands section Separate the Commands section into two subsections: single-phase skills (invocable via Skill tool with /) and meta-commands (typed as plain text, handled by the orchestrator via Task tool). Add a note explaining why the distinction matters in Claude Code where / triggers the Skill tool. --- examples/claude-code/CLAUDE.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/examples/claude-code/CLAUDE.md b/examples/claude-code/CLAUDE.md index 69bbbd7..beb42fc 100644 --- a/examples/claude-code/CLAUDE.md +++ b/examples/claude-code/CLAUDE.md @@ -71,15 +71,20 @@ SDD is the structured planning layer for substantial changes. | `none` | Return results inline only. Recommend enabling engram or openspec. | ### Commands + +#### Single-phase skills (invoke via Skill tool) - `/sdd-init` -> run `sdd-init` - `/sdd-explore ` -> run `sdd-explore` -- `/sdd-new ` -> run `sdd-explore` then `sdd-propose` -- `/sdd-continue [change]` -> create next missing artifact in dependency chain -- `/sdd-ff [change]` -> run `sdd-propose` -> `sdd-spec` -> `sdd-design` -> `sdd-tasks` - `/sdd-apply [change]` -> run `sdd-apply` in batches - `/sdd-verify [change]` -> run `sdd-verify` - `/sdd-archive [change]` -> run `sdd-archive` -- `/sdd-new`, `/sdd-continue`, and `/sdd-ff` are meta-commands handled by YOU (the orchestrator). Do NOT invoke them as skills. + +#### Meta-commands (type as text — orchestrator handles directly, NOT skills) +- `sdd-new ` -> orchestrate `sdd-explore` then `sdd-propose` via Task tool +- `sdd-continue [change]` -> determine next missing artifact and launch it via Task tool +- `sdd-ff [change]` -> orchestrate `sdd-propose` -> `sdd-spec` -> `sdd-design` -> `sdd-tasks` via Task tool + +> **Note:** Meta-commands are composite workflows. The orchestrator processes them by launching sub-agents for each phase — never by invoking the Skill tool. In Claude Code, `/` triggers the Skill tool, so these must be typed as plain text (e.g. `sdd-new my-feature`). If a sub-agent suggests "run /sdd-ff", show it to the user as a suggestion, do not auto-execute. ### Dependency Graph ```