From 1435f540ff5debe708d2fca2b231a993137c2bf6 Mon Sep 17 00:00:00 2001 From: Farda Karim <68191032+latreon@users.noreply.github.com> Date: Sun, 26 Jul 2026 12:04:21 +0200 Subject: [PATCH] docs: refresh command quick reference (#2533) Align the command catalog and retired-command guidance with the current skills-first surface. --- COMMANDS-QUICK-REF.md | 132 ++++++++++++++++++++++++++++++++++-------- 1 file changed, 107 insertions(+), 25 deletions(-) diff --git a/COMMANDS-QUICK-REF.md b/COMMANDS-QUICK-REF.md index 88569ad19..5fb87c0b4 100644 --- a/COMMANDS-QUICK-REF.md +++ b/COMMANDS-QUICK-REF.md @@ -1,6 +1,6 @@ # Commands Quick Reference -> 59 slash commands installed globally. Type `/` in any Claude Code session to invoke. +> 94 slash commands installed globally. Type `/` in any Claude Code session to invoke. --- @@ -9,12 +9,14 @@ | Command | What it does | |---------|-------------| | `/plan` | Restate requirements, assess risks, write step-by-step implementation plan — **waits for your confirm before touching code** | -| `/plan-canvas` | Open a plan or HTML artifact in the browser Plan Canvas — annotate elements, chat with the agent, approve or request changes in place | -| `/tdd` | Enforce test-driven development: scaffold interface → write failing test → implement → verify 80%+ coverage | -| `/code-review` | Full code quality, security, and maintainability review of changed files | +| `/plan-canvas` | Open a plan or HTML artifact in the browser Plan Canvas for annotate-and-approve review | +| `/plan-prd` | Generate a lean, problem-first PRD and hand off to `/plan` for implementation planning | +| `/feature-dev` | Guided feature development with codebase understanding and architecture focus | +| `/code-review` | Code review — local uncommitted changes or GitHub PR (pass PR number/URL for PR mode) | +| `/review-pr` | Comprehensive PR review using specialized agents | | `/build-fix` | Detect and fix build errors — delegates to the right build-resolver agent automatically | -| `/verify` | Run the full verification loop: build → lint → test → type-check | | `/quality-gate` | Quality gate check against project standards | +| `/santa-loop` | Adversarial dual-review convergence loop — two independent model reviewers must both approve before code ships | --- @@ -22,13 +24,13 @@ | Command | What it does | |---------|-------------| -| `/tdd` | Universal TDD workflow (any language) | -| `/e2e` | Generate + run Playwright end-to-end tests, capture screenshots/videos/traces | -| `/test-coverage` | Report test coverage, identify gaps | +| `/test-coverage` | Analyze coverage, identify gaps, and generate missing tests toward the target threshold | | `/go-test` | TDD workflow for Go (table-driven, 80%+ coverage with `go test -cover`) | | `/kotlin-test` | TDD for Kotlin (Kotest + Kover) | -| `/rust-test` | TDD for Rust (cargo test, integration tests) | +| `/rust-test` | TDD for Rust (cargo test, `cargo-llvm-cov`) | | `/cpp-test` | TDD for C++ (GoogleTest + gcov/lcov) | +| `/flutter-test` | Run Flutter/Dart tests (unit, widget, golden, integration), report and fix failures | +| `/react-test` | TDD for React (React Testing Library, Vitest or Jest, coverage targets) | --- @@ -36,12 +38,16 @@ | Command | What it does | |---------|-------------| -| `/code-review` | Universal code review | +| `/code-review` | Code review — local uncommitted changes or GitHub PR (pass PR number/URL for PR mode) | | `/python-review` | Python — PEP 8, type hints, security, idiomatic patterns | | `/go-review` | Go — idiomatic patterns, concurrency safety, error handling | | `/kotlin-review` | Kotlin — null safety, coroutine safety, clean architecture | | `/rust-review` | Rust — ownership, lifetimes, unsafe usage | | `/cpp-review` | C++ — memory safety, modern idioms, concurrency | +| `/flutter-review` | Flutter/Dart — widget best practices, state management, accessibility, security | +| `/react-review` | React/JSX — hook correctness, render performance, server/client boundaries, accessibility | +| `/vue-review` | Vue.js — Composition API correctness, reactivity, composable patterns, template security, accessibility, performance | +| `/fastapi-review` | FastAPI — async correctness, dependency injection, Pydantic schemas, security | --- @@ -49,12 +55,53 @@ | Command | What it does | |---------|-------------| -| `/build-fix` | Auto-detect language and fix build errors | +| `/build-fix` | Detect and fix build errors — delegates to the right build-resolver agent automatically | | `/go-build` | Fix Go build errors and `go vet` warnings | | `/kotlin-build` | Fix Kotlin/Gradle compiler errors | | `/rust-build` | Fix Rust build + borrow checker issues | | `/cpp-build` | Fix C++ CMake and linker problems | | `/gradle-build` | Fix Gradle errors for Android / KMP | +| `/flutter-build` | Fix Dart analyzer errors and Flutter build failures | +| `/react-build` | Fix React build failures (Vite, webpack, Next.js, CRA, Parcel, esbuild, Bun) | + +--- + +## Orchestrated Feature Workflows + +| Command | What it does | +|---------|-------------| +| `/orch-add-feature` | Build a brand-new feature end to end — research, plan, TDD, review, gated commit | +| `/orch-build-mvp` | Bootstrap a working MVP from a design/spec doc — ingest, slice, scaffold, TDD, review, gated commit | +| `/orch-change-feature` | Alter an existing feature to new desired behavior — update tests to the new spec, change impl, review, gated commit | +| `/orch-fix-defect` | Fix a bug — reproduce it as a failing regression test, fix to green, review, gated commit | +| `/orch-refine-code` | Behavior-preserving refactor — confirm tests green, restructure, keep green, review, gated commit | +| `/orch-review` | Run the orch-review native Workflow over a diff (local changes or a GitHub PR) and report blocking vs advisory findings | + +--- + +## PRP Workflow + +| Command | What it does | +|---------|-------------| +| `/prp-prd` | Interactive PRD generator — problem-first, hypothesis-driven, back-and-forth questioning | +| `/prp-plan` | Create a comprehensive feature implementation plan with codebase analysis and pattern extraction | +| `/prp-implement` | Execute an implementation plan with rigorous validation loops | +| `/prp-commit` | Quick commit with natural language file targeting | +| `/prp-pr` | Create a GitHub PR from the current branch with unpushed commits | + +--- + +## Epic Coordination (GitHub-native) + +| Command | What it does | +|---------|-------------| +| `/epic-decompose` | Break an epic into task children without creating task branches | +| `/epic-validate` | Validate epic readiness, dependencies, and coordination policy | +| `/epic-claim` | Claim an epic issue, stamp coordination state, and sync local ownership | +| `/epic-sync` | Sync epic issue bodies, labels, and local coordination snapshots from GitHub | +| `/epic-review` | Mark epic review requested, approved, or changes requested | +| `/epic-publish` | Publish a validated epic update back to the issue and local cache | +| `/epic-unblock` | Sweep blocked epic issues and reopen anything whose dependencies are closed | --- @@ -62,14 +109,12 @@ | Command | What it does | |---------|-------------| -| `/plan` | Implementation plan with risk assessment | +| `/plan` | Restate requirements, assess risks, write step-by-step implementation plan — **waits for your confirm before touching code** | | `/multi-plan` | Multi-model collaborative planning | | `/multi-workflow` | Multi-model collaborative development | | `/multi-backend` | Backend-focused multi-model development | | `/multi-frontend` | Frontend-focused multi-model development | | `/multi-execute` | Multi-model collaborative execution | -| `/orchestrate` | Guide for tmux/worktree multi-agent orchestration | -| `/devfleet` | Orchestrate parallel Claude Code agents via DevFleet | --- @@ -80,9 +125,8 @@ | `/save-session` | Save current session state to `~/.claude/session-data/` | | `/resume-session` | Load the most recent saved session from the canonical session store and resume from where you left off | | `/sessions` | Browse, search, and manage session history with aliases from `~/.claude/session-data/` (with legacy reads from `~/.claude/sessions/`) | -| `/checkpoint` | Mark a checkpoint in the current session | +| `/checkpoint` | Create, verify, or list workflow checkpoints after running verification checks | | `/aside` | Answer a quick side question without losing current task context | -| `/context-budget` | Analyse context window usage — find token overhead, optimise | --- @@ -116,12 +160,12 @@ executable instructions or policy. | `/learn-eval` | Extract patterns + self-evaluate quality before saving | | `/evolve` | Analyse learned instincts, suggest evolved skill structures | | `/promote` | Promote project-scoped instincts to global scope | +| `/prune` | Delete pending instincts older than 30 days that were never promoted | | `/instinct-status` | Show all learned instincts (project + global) with confidence scores | | `/instinct-export` | Export instincts to a file | | `/instinct-import` | Import instincts from a file or URL | | `/skill-create` | Analyse local git history → generate a reusable skill | | `/skill-health` | Skill portfolio health dashboard with analytics | -| `/rules-distill` | Scan skills, extract cross-cutting principles, distill into rules | --- @@ -130,7 +174,6 @@ executable instructions or policy. | Command | What it does | |---------|-------------| | `/refactor-clean` | Remove dead code, consolidate duplicates, clean up structure | -| `/prompt-optimize` | Analyse a draft prompt and output an optimised ECC-enriched version | --- @@ -138,8 +181,8 @@ executable instructions or policy. | Command | What it does | |---------|-------------| -| `/docs` | Look up current library/API documentation via Context7 | -| `/update-docs` | Update project documentation | +| `/ecc-guide` | Navigate ECC's current agents, skills, commands, hooks, install profiles, and docs from the live repository surface | +| `/update-docs` | Sync documentation from source-of-truth files such as scripts, schemas, routes, and exports | | `/update-codemaps` | Regenerate codemaps for the codebase | --- @@ -150,7 +193,8 @@ executable instructions or policy. |---------|-------------| | `/loop-start` | Start a recurring agent loop on an interval | | `/loop-status` | Check status of running loops | -| `/claw` | Start NanoClaw v2 — persistent REPL with model routing, skill hot-load, branching, and metrics | +| `/gan-build` | Generator/evaluator build loop for implementation tasks, bounded iterations and scoring | +| `/gan-design` | Generator/evaluator design loop for frontend or visual work, bounded iterations and scoring | --- @@ -159,24 +203,62 @@ executable instructions or policy. | Command | What it does | |---------|-------------| | `/projects` | List known projects and their instinct statistics | +| `/project-init` | Detect a project's stack and produce a dry-run ECC onboarding plan | | `/harness-audit` | Audit the agent harness configuration for reliability and cost | -| `/eval` | Run the evaluation harness | | `/model-route` | Route a task to the right model (Haiku / Sonnet / Opus) | | `/pm2` | PM2 process manager initialisation | | `/setup-pm` | Configure package manager (npm / pnpm / yarn / bun) | +| `/auto-update` | Pull the latest ECC repo changes and reinstall the current managed targets | +| `/cost-report` | Generate a local Claude Code cost report from a cost-tracker SQLite database | +| `/security-scan` | Run AgentShield against agent, hook, MCP, permission, and secret surfaces | +| `/jira` | Retrieve a Jira ticket, analyze requirements, update status, or add comments | +| `/pr` | Create a GitHub PR from current branch with unpushed commits | +| `/hookify` | Create hooks to prevent unwanted behaviors from conversation analysis or explicit instructions | +| `/hookify-configure` | Enable or disable hookify rules interactively | +| `/hookify-list` | List all configured hookify rules | +| `/hookify-help` | Get help with the hookify system | + +--- + +## Marketing + +| Command | What it does | +|---------|-------------| +| `/marketing-campaign` | Plan and execute a full marketing campaign — positioning, landing page copy, email sequence, social posts, ad variants, video scripts, content calendar | + +--- + +## Retired Commands + +These slash commands were retired in favor of skills. The command files still exist under `legacy-command-shims/commands/` for backward compatibility (not part of the default installed surface), but the maintained workflow now lives in the listed skill — invoke the skill directly instead: + +| Retired command | Use this skill instead | +|---|---| +| `/tdd` | `tdd-workflow` | +| `/eval` | `eval-harness` | +| `/verify` | `verification-loop` | +| `/e2e` | `e2e-testing` | +| `/docs` | `documentation-lookup` | +| `/claw` | `nanoclaw-repl` | +| `/context-budget` | `context-budget` | +| `/devfleet` | `claude-devfleet` | +| `/orchestrate` | `dmux-workflows` and `autonomous-agent-harness` | +| `/prompt-optimize` | `prompt-optimizer` | +| `/rules-distill` | `rules-distill` | +| `/agent-sort` | `agent-sort` | --- ## Quick Decision Guide ``` -Starting a new feature? → /plan first, then /tdd +Starting a new feature? → /plan first, then TDD via the tdd-workflow skill Code just written? → /code-review Build broken? → /build-fix -Need live docs? → /docs +Need live docs? → the documentation-lookup skill Session about to end? → /save-session or /learn-eval Resuming next day? → /resume-session -Context getting heavy? → /context-budget then /checkpoint +Context getting heavy? → the context-budget skill Want to extract what you learned? → /learn-eval then /evolve Running repeated tasks? → /loop-start ```