feat(humanizer): update action command templates [skip-docs]
Wave 5 Step 15. Threads --raw plumbing through all seven action
command templates and adds a shape test covering structural plumbing
plus help.md's plain-language vocabulary.
- commands/fix.md: --raw flag parsed; fix-plan rendering groups by
userActionLanguage; humanized title/description/recommendation are
rendered verbatim from the cross-referenced scan envelope.
- commands/rollback.md: terminology pass — "manifest" → "list of
changes" in user-facing copy; the file name manifest.yaml is kept
as the machine contract; --raw threaded through.
- commands/plan.md: --raw forwarded to the planner-agent's prompt;
agent now instructed to group actions by userImpactCategory and
lead with userActionLanguage; bash block added for flag parsing.
- commands/implement.md: --raw forwarded to the implementer-agent's
prompt; progress-log lines now reference the humanized titles
already present in the action plan.
- commands/cleanup.md: --raw accepted as no-op (cleanup is
file-management only, no findings prose); bash block added.
- commands/help.md: full plain-language pass — "PreToolUse" and
"frontmatter" jargon removed from user-facing copy; new
vocabulary table surfaces the humanized userImpactCategory and
userActionLanguage labels ("Configuration mistake", "Conflict",
"Wasted tokens", "Missed opportunity", "Dead config" / "Fix this
now", "Fix soon", "Fix when convenient", "Optional cleanup",
"FYI"); --raw documented as global pass-through flag.
- commands/interview.md: --raw accepted as no-op; "unused hooks"
question phrased as "unused automation that runs at specific
events" in user-facing copy.
tests/commands/action-commands-shape.test.mjs (new, +6 tests, 780 → 786):
- structural: bash block + Read tool + --raw/$ARGUMENTS plumbing
across all 7 files
- help.md vocabulary: ≥3 userImpactCategory labels and ≥3
userActionLanguage phrases present
- help.md jargon: no bare "PreToolUse" or "frontmatter" in copy
This commit is contained in:
parent
6f38a6340e
commit
347d4a2c4c
8 changed files with 228 additions and 40 deletions
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
name: config-audit:help
|
||||
description: Show all available config-audit commands
|
||||
allowed-tools: Read
|
||||
allowed-tools: Read, Bash
|
||||
model: sonnet
|
||||
---
|
||||
|
||||
|
|
@ -11,6 +11,19 @@ model: sonnet
|
|||
|
||||
Just run `/config-audit` — it auto-detects your project scope and runs a full audit. No setup needed.
|
||||
|
||||
The default output is written in plain language: each finding is grouped by impact ("Configuration mistake," "Conflict," "Wasted tokens," "Missed opportunity," "Dead config") and led with an urgency phrase ("Fix this now," "Fix soon," "Fix when convenient," "Optional cleanup," "FYI").
|
||||
|
||||
If you prefer the v5.0.0 verbatim output (technical IDs, raw severity, no plain-language wording), pass `--raw` to any command — it's threaded through every CLI in the toolchain. Use the Read tool on the saved JSON to consume it programmatically.
|
||||
|
||||
```bash
|
||||
# Examples — every command accepts --raw for byte-stable v5.0.0 output
|
||||
RAW_FLAG=""
|
||||
if echo "$ARGUMENTS" | grep -q -- "--raw"; then RAW_FLAG="--raw"; fi
|
||||
# /config-audit posture --raw
|
||||
# /config-audit tokens --raw
|
||||
# /config-audit fix --raw
|
||||
```
|
||||
|
||||
## All Commands
|
||||
|
||||
### Core
|
||||
|
|
@ -22,15 +35,15 @@ Just run `/config-audit` — it auto-detects your project scope and runs a full
|
|||
| `/config-audit tokens` | Opus-4.7 token hotspots; optional `--accurate-tokens` API calibration |
|
||||
| `/config-audit manifest` | Ranked table of every system-prompt token source |
|
||||
| `/config-audit feature-gap` | Deep analysis of features you're not using |
|
||||
| `/config-audit fix` | Auto-fix deterministic issues with backup |
|
||||
| `/config-audit rollback` | Restore configuration from a backup |
|
||||
| `/config-audit fix` | Auto-fix deterministic issues; a copy of every changed file is saved first so you can roll back with one command |
|
||||
| `/config-audit rollback` | Restore configuration from a saved copy |
|
||||
|
||||
### Planning & Implementation
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/config-audit plan` | Generate prioritized action plan from audit findings |
|
||||
| `/config-audit implement` | Execute action plan with automatic backup + verification |
|
||||
| `/config-audit implement` | Execute action plan; a copy of every changed file is saved first, and a verification pass runs after |
|
||||
| `/config-audit interview` | Set preferences to customize the action plan _(optional)_ |
|
||||
|
||||
### Monitoring
|
||||
|
|
@ -38,7 +51,7 @@ Just run `/config-audit` — it auto-detects your project scope and runs a full
|
|||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/config-audit drift` | Compare current config against a saved baseline |
|
||||
| `/config-audit plugin-health` | Audit plugin structure and frontmatter quality |
|
||||
| `/config-audit plugin-health` | Audit plugin structure and the metadata block at the top of each command/agent file |
|
||||
| `/config-audit whats-active` | Show active plugins/skills/MCP/hooks/CLAUDE.md with token estimates |
|
||||
|
||||
### Utility
|
||||
|
|
@ -55,6 +68,25 @@ Just run `/config-audit` — it auto-detects your project scope and runs a full
|
|||
| `/config-audit discover` | Run only the discovery phase (find config files) |
|
||||
| `/config-audit analyze` | Run only the analysis phase (generate report) |
|
||||
|
||||
## Plain-language vocabulary
|
||||
|
||||
The toolchain uses these terms when describing findings:
|
||||
|
||||
| User-facing label | What it means |
|
||||
|-------------------|---------------|
|
||||
| Fix this now | Something is broken or risky and should be addressed immediately |
|
||||
| Fix soon | High-priority issue worth scheduling this week |
|
||||
| Fix when convenient | Real issue but not urgent |
|
||||
| Optional cleanup | Tidy-up that improves polish but isn't required |
|
||||
| FYI | Informational; no action expected |
|
||||
| Configuration mistake | A configuration file has an error or omission |
|
||||
| Conflict | Two configuration sources disagree |
|
||||
| Wasted tokens | Configuration is loading content that costs tokens without payback |
|
||||
| Missed opportunity | A Claude Code feature you aren't using that could help your project |
|
||||
| Dead config | Configuration that has no effect (e.g., a permission that's also denied) |
|
||||
|
||||
Use `--raw` if you'd rather see the v5.0.0 verbatim output (technical IDs and raw severity).
|
||||
|
||||
## Scope Override
|
||||
|
||||
By default, `/config-audit` auto-detects scope from your current directory:
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue