347d4a2c4c
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
113 lines
4.6 KiB
Markdown
113 lines
4.6 KiB
Markdown
---
|
|
name: config-audit:help
|
|
description: Show all available config-audit commands
|
|
allowed-tools: Read, Bash
|
|
model: sonnet
|
|
---
|
|
|
|
# Config-Audit: Help
|
|
|
|
## Getting Started
|
|
|
|
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
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/config-audit` | Full audit with auto-scope detection |
|
|
| `/config-audit posture` | Quick scorecard with A-F grades per area (10 areas) |
|
|
| `/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; 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; 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
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/config-audit drift` | Compare current config against a saved baseline |
|
|
| `/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
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/config-audit status` | Show current session state and progress |
|
|
| `/config-audit cleanup` | Clean up old session directories |
|
|
|
|
### Advanced (workflow phases)
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/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:
|
|
- Inside a git repo → scans the repo
|
|
- In `$HOME` → scans global config only
|
|
- Elsewhere → scans current directory
|
|
|
|
Override with: `/config-audit current`, `/config-audit repo`, `/config-audit home`, `/config-audit full`
|
|
|
|
## Typical Workflows
|
|
|
|
**First time?** Just run `/config-audit`.
|
|
|
|
**Want to fix things?** Run `/config-audit` then `/config-audit fix`.
|
|
|
|
**Full optimization:**
|
|
1. `/config-audit` — see what you have
|
|
2. `/config-audit plan` — create action plan
|
|
3. `/config-audit implement` — execute with backups
|
|
|
|
**Track changes over time:**
|
|
1. `/config-audit drift --save` — save baseline
|
|
2. _(make changes)_
|
|
3. `/config-audit drift` — see what changed
|