claude-code-autoconfig 1.0.143 → 1.0.144

package/.claude/commands/autoconfig-update.md

@@ -1,5 +1,9 @@
 <!-- @description Manages and installs updates to Claude Code configuration. -->
 <!-- @version 1 -->
+<!-- @response updates-available | Displays list of pending updates with install/review options. -->
+<!-- @response up-to-date | All updates are already installed. -->
+<!-- @sideeffect Pulls latest update files from npm, executes update instructions, tracks applied updates -->
+<!-- @example /autoconfig-update | Check for and install configuration updates -->
 
 <!-- @applied
 -->

package/.claude/commands/autoconfig.md

@@ -1,5 +1,9 @@
-<!-- @description The command you just ran. Analyzes your project and populates CLAUDE.md with real context. Re-run anytime your stack changes. -->
+<!-- @description Analyzes your project and populates CLAUDE.md with real context. Re-run anytime your stack changes. -->
 <!-- @version 8 -->
+<!-- @response success | CLAUDE.md populated, settings configured, docs opened in browser. -->
+<!-- @response no-project | No project detected — asks user to confirm directory. -->
+<!-- @sideeffect Generates CLAUDE.md, settings.json, hooks, and MEMORY.md -->
+<!-- @example /autoconfig | Analyze project and configure Claude -->
 
 # Autoconfig
 

package/.claude/commands/commit-and-push.md

@@ -1,5 +1,9 @@
 <!-- @description Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes. -->
 <!-- @version 1 -->
+<!-- @response success | Changes committed and pushed to current branch. -->
+<!-- @response test-failure | Tests failed — no commit made. -->
+<!-- @sideeffect Runs test suite, stages all changes, creates git commit, pushes to remote -->
+<!-- @example /commit-and-push | Run tests, commit, and push -->
 
 # Commit and Push
 

package/.claude/commands/enable-retro.md

@@ -1,5 +1,8 @@
 <!-- @description (Experimental) Enable Claude to log tech debt it encounters into .claude/retro. -->
 <!-- @version 1 -->
+<!-- @response success | Retro enabled — Claude will log tech debt to .claude/retro/ when encountered. -->
+<!-- @sideeffect Creates .claude/retro/README.md, adds agent, updates CLAUDE.md -->
+<!-- @example /enable-retro | Activate tech debt tracking -->
 
 # Enable Retro
 

package/.claude/commands/gls.md

@@ -1,5 +1,15 @@
 <!-- @screenshotDir /c/Users/andre/OneDrive/Pictures/Screenshots 1 -->
+<!-- @description Get the latest screenshot(s) and display them. -->
 <!-- @version 1 -->
+<!-- @param count | integer | optional | Number of screenshots to display. Use /gls-N syntax. Default: 1. Min: 1. -->
+<!-- @param path | string | optional | Screenshot directory path. Saved for future use. Auto-detected if omitted. -->
+<!-- @response success | Displays requested screenshot(s) from newest to oldest. -->
+<!-- @response no-screenshots | Directory exists but contains no image files. -->
+<!-- @response no-directory | Unable to detect screenshot directory — prompts for path. -->
+<!-- @sideeffect Saves detected screenshot path to command file on first run -->
+<!-- @example /gls | Display the most recent screenshot -->
+<!-- @example /gls-3 | Display the 3 most recent screenshots -->
+<!-- @example /gls /path/to/dir | Use a specific screenshot directory -->
 Get the latest screenshot(s) and display them.
 
 Usage:

package/.claude/commands/recover-context.md

@@ -1,5 +1,14 @@
 <!-- @description Recovers conversation context from the session transcript after compaction. -->
 <!-- @version 4 -->
+<!-- @param minutes | integer | required | How far back to recover, in minutes. Leading dash optional. Min: 1. -->
+<!-- @param --show | flag | optional | Opens the extracted transcript in your default editor. -->
+<!-- @response success | ~{tokens} tokens recovered ({N} messages across {sessions} session(s), last {minutes} min). -->
+<!-- @response no-transcript | No transcript files found. -->
+<!-- @response no-messages | No messages found in the requested time range. -->
+<!-- @sideeffect Reads .jsonl transcripts from ~/.claude/projects/, writes temp file -->
+<!-- @example /recover-context -60 | Last 60 minutes of conversation -->
+<!-- @example /recover-context 120 | Last 2 hours (dash optional) -->
+<!-- @example /recover-context -60 --show | Last 60 min + open transcript file -->
 Recover recent conversation context from the raw session transcript on disk.
 
 Usage:

package/.claude/commands/show-docs.md

@@ -1,5 +1,9 @@
 <!-- @description Opens the interactive docs in your browser. -->
 <!-- @version 2 -->
+<!-- @response success | Docs synced and opened in default browser. -->
+<!-- @response no-docs | Docs file not found — run /autoconfig first. -->
+<!-- @sideeffect Runs sync-docs.js to refresh content, opens browser -->
+<!-- @example /show-docs | Open interactive documentation -->
 
 # Show Docs
 

package/.claude/commands/sync-claude-md.md

@@ -1,5 +1,8 @@
 <!-- @description Re-analyzes your project and updates CLAUDE.md to reflect current state. -->
 <!-- @version 2 -->
+<!-- @response success | CLAUDE.md updated with current project state. -->
+<!-- @sideeffect Overwrites auto-generated sections of CLAUDE.md, preserves Discoveries section -->
+<!-- @example /sync-claude-md | Re-scan project and update CLAUDE.md -->
 
 # Sync CLAUDE.md
 

package/.claude/commands/test.md

@@ -1,5 +1,12 @@
 <!-- @description Runs your test suite. Auto-detects Jest, Vitest, Pytest, Go, RSpec, or falls back to npm test. -->
 <!-- @version 1 -->
+<!-- @param scope | string | optional | File, directory, or pattern to limit test run. Runs full suite if omitted. -->
+<!-- @response success | Test suite passes. -->
+<!-- @response failure | Test suite fails with non-zero exit code. -->
+<!-- @sideeffect Executes detected test runner command -->
+<!-- @example /test | Run full test suite -->
+<!-- @example /test src/auth | Run tests in src/auth directory -->
+<!-- @example /test --coverage | Run tests with coverage report -->
 
 # Run Tests
 

package/.claude/commands/validate-cca-install.md

@@ -1,5 +1,9 @@
 <!-- @description Validates your claude-code-autoconfig installation against the latest published version. -->
 <!-- @version 1 -->
+<!-- @response valid | Install validated — all checks passed. -->
+<!-- @response issues | Validation found {N} issue(s) with fix suggestions. -->
+<!-- @sideeffect Read-only. Downloads latest package to temp dir for comparison, then cleans up. -->
+<!-- @example /validate-cca-install | Run full installation validation -->
 Validate the current claude-code-autoconfig installation. Reports what's correct, what's outdated, and what's missing. **Does not modify anything.**
 
 Usage:

package/.claude/docs/autoconfig.docs.html

@@ -34,7 +34,7 @@
         }
 
         .container {
-            max-width: 900px;
+            max-width: 1100px;
             margin: 0 auto;
             padding: 40px 20px;
             min-height: 100vh;
@@ -395,8 +395,7 @@
 
         .tree-content {
             padding: 16px 16px 8px 16px;
-            overflow-y: auto;
-            overflow-x: hidden;
+            overflow: auto;
             flex: 1;
             min-height: 0;
         }
@@ -745,7 +744,7 @@
             background: var(--bg-secondary);
             border: 1px solid var(--bg-elevated);
             border-radius: 12px;
-            max-width: 800px;
+            max-width: 1000px;
             width: 100%;
             max-height: 80vh;
             display: flex;
@@ -1201,7 +1200,7 @@
                 item.style.position = '';
             });
             
-            treeSide.style.width = (maxWidth + 32) + 'px';
+            treeSide.style.width = Math.round((maxWidth + 32) * 1.25) + 'px';
             treeSide.style.paddingLeft = '8px';
             treeSide.style.paddingRight = '8px';
         }
@@ -1268,7 +1267,7 @@
                 title: '.claude/ Directory',
                 desc: 'Commands, rules, settings, and these docs. Keeps configuration organized as your project grows.'
             },
-                                                                                                                        'rules': {
+                                                                                                                                                'rules': {
                 title: 'rules/',
                 desc: 'Path-scoped context that loads when Claude works on matching files.'
             },
@@ -1290,57 +1289,57 @@
             },
             'autoconfig-update': {
                 title: 'autoconfig-update.md',
-                desc: 'Manages and installs updates to Claude Code configuration.',
+                desc: 'Manages and installs updates to Claude Code configuration.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>updates-available</code></td><td style="padding: 4px 8px;">Displays list of pending updates with install/review options.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>up-to-date</code></td><td style="padding: 4px 8px;">All updates are already installed.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Pulls latest update files from npm, executes update instructions, tracks applied updates</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/autoconfig-update</code> <span style="opacity: 0.6;">— Check for and install configuration updates</span></div></div></div>',
                 trigger: '/autoconfig-update'
             },
             'autoconfig': {
                 title: 'autoconfig.md',
-                desc: 'The command you just ran. Analyzes your project and populates CLAUDE.md with real context. Re-run anytime your stack changes.',
+                desc: 'Analyzes your project and populates CLAUDE.md with real context. Re-run anytime your stack changes.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">CLAUDE.md populated, settings configured, docs opened in browser.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-project</code></td><td style="padding: 4px 8px;">No project detected — asks user to confirm directory.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Generates CLAUDE.md, settings.json, hooks, and MEMORY.md</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/autoconfig</code> <span style="opacity: 0.6;">— Analyze project and configure Claude</span></div></div></div>',
                 trigger: '/autoconfig'
             },
             'commit-and-push': {
                 title: 'commit-and-push.md',
-                desc: 'Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes.',
+                desc: 'Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Changes committed and pushed to current branch.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>test-failure</code></td><td style="padding: 4px 8px;">Tests failed — no commit made.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs test suite, stages all changes, creates git commit, pushes to remote</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/commit-and-push</code> <span style="opacity: 0.6;">— Run tests, commit, and push</span></div></div></div>',
                 trigger: '/commit-and-push'
             },
             'enable-retro': {
                 title: 'enable-retro.md',
-                desc: '(Experimental) Enable Claude to log tech debt it encounters into .claude/retro.',
+                desc: '(Experimental) Enable Claude to log tech debt it encounters into .claude/retro.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Retro enabled — Claude will log tech debt to .claude/retro/ when encountered.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Creates .claude/retro/README.md, adds agent, updates CLAUDE.md</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/enable-retro</code> <span style="opacity: 0.6;">— Activate tech debt tracking</span></div></div></div>',
                 trigger: '/enable-retro'
             },
             'gls': {
                 title: 'gls.md',
-                desc: 'gls.md in commands/<div style="margin-top: 10px;"><strong>Usage:</strong><ul style="margin: 6px 0 0 0; padding-left: 20px; list-style: disc;"><li><code>/gls</code> - Get and display the most recent screenshot</li><li><code>/gls-2</code> - Get and display the 2 most recent screenshots</li><li><code>/gls-3</code> - Get and display the 3 most recent screenshots</li><li><code>/gls-N</code> - Get and display the N most recent screenshots</li><li><code>/gls /path/to/dir</code> - Use a specific directory and save it</li></ul></div>',
+                desc: 'Get the latest screenshot(s) and display them.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>count</code></td><td style="padding: 4px 8px;"><code>integer</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">Number of screenshots to display. Use /gls-N syntax. Default: 1. Min: 1.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>path</code></td><td style="padding: 4px 8px;"><code>string</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">Screenshot directory path. Saved for future use. Auto-detected if omitted.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Displays requested screenshot(s) from newest to oldest.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-screenshots</code></td><td style="padding: 4px 8px;">Directory exists but contains no image files.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-directory</code></td><td style="padding: 4px 8px;">Unable to detect screenshot directory — prompts for path.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Saves detected screenshot path to command file on first run</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/gls</code> <span style="opacity: 0.6;">— Display the most recent screenshot</span></div><div><code>/gls-3</code> <span style="opacity: 0.6;">— Display the 3 most recent screenshots</span></div><div><code>/gls /path/to/dir</code> <span style="opacity: 0.6;">— Use a specific screenshot directory</span></div></div></div>',
                 trigger: '/gls'
             },
             'publish': {
                 title: 'publish.md',
-                desc: 'Runs tests, bumps version, commits, and publishes to npm.',
+                desc: 'Runs tests, bumps version, commits, and publishes to npm.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div>',
                 trigger: '/publish'
             },
             'recover-context': {
                 title: 'recover-context.md',
-                desc: 'Recovers conversation context from the session transcript after compaction.<div style="margin-top: 10px;"><strong>Usage:</strong><ul style="margin: 6px 0 0 0; padding-left: 20px; list-style: disc;"><li><code>/recover-context -60</code> — last 60 minutes of conversation</li><li><code>/recover-context -60 --show</code> — same, but also opens the transcript in your editor</li></ul></div>',
+                desc: 'Recovers conversation context from the session transcript after compaction.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>minutes</code></td><td style="padding: 4px 8px;"><code>integer</code></td><td style="padding: 4px 8px;">required</td><td style="padding: 4px 8px;">How far back to recover, in minutes. Leading dash optional. Min: 1.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>--show</code></td><td style="padding: 4px 8px;"><code>flag</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">Opens the extracted transcript in your default editor.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">~{tokens} tokens recovered ({N} messages across {sessions} session(s), last {minutes} min).</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-transcript</code></td><td style="padding: 4px 8px;">No transcript files found.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-messages</code></td><td style="padding: 4px 8px;">No messages found in the requested time range.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Reads .jsonl transcripts from ~/.claude/projects/, writes temp file</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/recover-context -60</code> <span style="opacity: 0.6;">— Last 60 minutes of conversation</span></div><div><code>/recover-context 120</code> <span style="opacity: 0.6;">— Last 2 hours (dash optional)</span></div><div><code>/recover-context -60 --show</code> <span style="opacity: 0.6;">— Last 60 min + open transcript file</span></div></div></div>',
                 trigger: '/recover-context'
             },
             'show-docs': {
                 title: 'show-docs.md',
-                desc: 'Opens the interactive docs in your browser.',
+                desc: 'Opens the interactive docs in your browser.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Docs synced and opened in default browser.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-docs</code></td><td style="padding: 4px 8px;">Docs file not found — run /autoconfig first.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs sync-docs.js to refresh content, opens browser</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/show-docs</code> <span style="opacity: 0.6;">— Open interactive documentation</span></div></div></div>',
                 trigger: '/show-docs'
             },
             'sync-claude-md': {
                 title: 'sync-claude-md.md',
-                desc: 'Re-analyzes your project and updates CLAUDE.md to reflect current state.',
+                desc: 'Re-analyzes your project and updates CLAUDE.md to reflect current state.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">CLAUDE.md updated with current project state.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Overwrites auto-generated sections of CLAUDE.md, preserves Discoveries section</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/sync-claude-md</code> <span style="opacity: 0.6;">— Re-scan project and update CLAUDE.md</span></div></div></div>',
                 trigger: '/sync-claude-md'
             },
             'test': {
                 title: 'test.md',
-                desc: 'Runs your test suite. Auto-detects Jest, Vitest, Pytest, Go, RSpec, or falls back to npm test.',
+                desc: 'Runs your test suite. Auto-detects Jest, Vitest, Pytest, Go, RSpec, or falls back to npm test.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>scope</code></td><td style="padding: 4px 8px;"><code>string</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">File, directory, or pattern to limit test run. Runs full suite if omitted.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Test suite passes.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>failure</code></td><td style="padding: 4px 8px;">Test suite fails with non-zero exit code.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Executes detected test runner command</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/test</code> <span style="opacity: 0.6;">— Run full test suite</span></div><div><code>/test src/auth</code> <span style="opacity: 0.6;">— Run tests in src/auth directory</span></div><div><code>/test --coverage</code> <span style="opacity: 0.6;">— Run tests with coverage report</span></div></div></div>',
                 trigger: '/test'
             },
             'validate-cca-install': {
                 title: 'validate-cca-install.md',
-                desc: 'Validates your claude-code-autoconfig installation against the latest published version.<div style="margin-top: 10px;"><strong>Usage:</strong><ul style="margin: 6px 0 0 0; padding-left: 20px; list-style: disc;"><li><code>/validate-cca-install</code> — run a full validation check</li></ul></div>',
+                desc: 'Validates your claude-code-autoconfig installation against the latest published version.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>valid</code></td><td style="padding: 4px 8px;">Install validated — all checks passed.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>issues</code></td><td style="padding: 4px 8px;">Validation found {N} issue(s) with fix suggestions.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Read-only. Downloads latest package to temp dir for comparison, then cleans up.</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/validate-cca-install</code> <span style="opacity: 0.6;">— Run full installation validation</span></div></div></div>',
                 trigger: '/validate-cca-install'
             },
             'create-retro-item-agent': {
@@ -1579,7 +1578,7 @@ CRITICAL: A plausible-looking cause from code reading is NOT confirmed evidence.
 
 > Run \`/autoconfig\` to populate this based on your project.`
             },
-                                                                                                                        'autoconfig-update': {
+                                                                                                                                                'autoconfig-update': {
                 filename: 'autoconfig-update.md',
                 content: `<!-- @applied
 -->

package/.claude/scripts/sync-docs.js

@@ -82,33 +82,103 @@ function extractDescription(content, ext) {
 }
 
 /**
- * Extract usage lines from a command file's content.
- * Looks for a "Usage:" section and returns HTML-formatted usage list.
+ * Extract structured Swagger-style metadata from command file content.
+ * Parses @param, @response, @sideeffect, and @example comments.
  */
-function extractUsage(content) {
+function extractSwaggerMeta(content) {
+  const params = [];
+  const responses = [];
+  const examples = [];
+  let sideeffect = null;
+
   const lines = content.split(/\r?\n/);
-  const usageIdx = lines.findIndex(l => /^Usage:$/i.test(l.trim()));
-  if (usageIdx === -1) return null;
-
-  const usageLines = [];
-  for (let i = usageIdx + 1; i < lines.length; i++) {
-    const line = lines[i].trim();
-    if (line.startsWith('- ')) {
-      // Convert markdown backticks to <code> tags and strip leading "- "
-      const item = line.slice(2)
-        .replace(/`([^`]+)`/g, '<code>$1</code>');
-      usageLines.push(item);
-    } else if (line === '') {
-      continue; // skip blank lines within usage block
-    } else {
-      break; // end of usage block
+  for (const line of lines) {
+    const paramMatch = line.match(/<!--\s*@param\s+(.+?)\s*-->/);
+    if (paramMatch) {
+      const parts = paramMatch[1].split('|').map(s => s.trim());
+      if (parts.length >= 4) {
+        params.push({ name: parts[0], type: parts[1], required: parts[2], desc: parts[3] });
+      }
+    }
+    const respMatch = line.match(/<!--\s*@response\s+(.+?)\s*-->/);
+    if (respMatch) {
+      const parts = respMatch[1].split('|').map(s => s.trim());
+      if (parts.length >= 2) {
+        responses.push({ status: parts[0], desc: parts[1] });
+      }
+    }
+    const exMatch = line.match(/<!--\s*@example\s+(.+?)\s*-->/);
+    if (exMatch) {
+      const parts = exMatch[1].split('|').map(s => s.trim());
+      if (parts.length >= 2) {
+        examples.push({ usage: parts[0], desc: parts[1] });
+      }
+    }
+    const seMatch = line.match(/<!--\s*@sideeffect\s+(.+?)\s*-->/);
+    if (seMatch) {
+      sideeffect = seMatch[1].trim();
+    }
+  }
+
+  return { params, responses, examples, sideeffect };
+}
+
+/**
+ * Build Swagger-style HTML from extracted metadata.
+ */
+function buildSwaggerHtml(meta) {
+  const parts = [];
+
+  // Parameters table
+  if (meta.params.length > 0) {
+    let table = '<div style="margin-top: 12px;"><strong>Parameters</strong>';
+    table += '<table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;">';
+    table += '<tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr>';
+    for (const p of meta.params) {
+      table += `<tr style="border-bottom: 1px solid var(--border);">`;
+      table += `<td style="padding: 4px 8px; white-space: nowrap;"><code>${p.name}</code></td>`;
+      table += `<td style="padding: 4px 8px;"><code>${p.type}</code></td>`;
+      table += `<td style="padding: 4px 8px;">${p.required}</td>`;
+      table += `<td style="padding: 4px 8px;">${p.desc}</td>`;
+      table += `</tr>`;
+    }
+    table += '</table></div>';
+    parts.push(table);
+  } else {
+    parts.push('<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div>');
+  }
+
+  // Responses table
+  if (meta.responses.length > 0) {
+    let table = '<div style="margin-top: 12px;"><strong>Responses</strong>';
+    table += '<table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;">';
+    table += '<tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr>';
+    for (const r of meta.responses) {
+      table += `<tr style="border-bottom: 1px solid var(--border);">`;
+      table += `<td style="padding: 4px 8px; white-space: nowrap;"><code>${r.status}</code></td>`;
+      table += `<td style="padding: 4px 8px;">${r.desc}</td>`;
+      table += `</tr>`;
+    }
+    table += '</table></div>';
+    parts.push(table);
+  }
+
+  // Side effects
+  if (meta.sideeffect) {
+    parts.push(`<div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">${meta.sideeffect}</div></div>`);
+  }
+
+  // Examples
+  if (meta.examples.length > 0) {
+    let html = '<div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;">';
+    for (const ex of meta.examples) {
+      html += `<div><code>${ex.usage}</code> <span style="opacity: 0.6;">— ${ex.desc}</span></div>`;
     }
+    html += '</div></div>';
+    parts.push(html);
   }
-  if (usageLines.length === 0) return null;
 
-  // Build an HTML list
-  const listItems = usageLines.map(l => `<li>${l}</li>`).join('');
-  return `<div style="margin-top: 10px;"><strong>Usage:</strong><ul style="margin: 6px 0 0 0; padding-left: 20px; list-style: disc;">${listItems}</ul></div>`;
+  return parts.length > 0 ? parts.join('') : null;
 }
 
 /**
@@ -200,9 +270,10 @@ function scanFiles() {
       const desc = extractDescription(content, ext) || `${file} in ${folder}/`;
       const trigger = deriveTrigger(folder, file, content);
       const preview = generatePreview(content, ext);
-      const usage = (folder === 'commands') ? extractUsage(content) : null;
+      const swagger = (folder === 'commands') ? extractSwaggerMeta(content) : null;
+      const swaggerHtml = swagger ? buildSwaggerHtml(swagger) : null;
 
-      entries.push({ key, folder, file, desc, trigger, preview, usage });
+      entries.push({ key, folder, file, desc, trigger, preview, swaggerHtml });
     }
   }
 
@@ -349,8 +420,8 @@ function generateTreeInfo(entries) {
     if (entry.isEmptyFolder) continue;
 
     let fullDesc = entry.desc;
-    if (entry.usage) {
-      fullDesc += entry.usage;
+    if (entry.swaggerHtml) {
+      fullDesc += entry.swaggerHtml;
     }
     const escapedDesc = fullDesc.replace(/'/g, "\\'");
     lines.push(`            '${entry.key}': {`);

package/bin/cli.js

@@ -617,7 +617,13 @@ const bootstrapMode = process.argv.includes('--bootstrap');
 if (bootstrapMode || insideClaude) {
   if (!bootstrapMode) {
     // insideClaude without --bootstrap: show guidance
-    console.log('\x1b[32m%s\x1b[0m', `✅ Files installed. Run ${launchCommand} to continue.`);
+    console.log();
+    console.log('\x1b[32m%s\x1b[0m', `✅ Autoconfig installed successfully.`);
+    console.log();
+    console.log('\x1b[33m%s\x1b[0m', `⚡ NEXT STEP: Type ${launchCommand} below and press Enter to complete setup.`);
+    console.log();
+    console.log('\x1b[90m%s\x1b[0m', `   (This CLI can't auto-trigger slash commands inside an active Claude session.`);
+    console.log('\x1b[90m%s\x1b[0m', `   Just type "${launchCommand}" at the prompt and Claude will handle the rest.)`);
     console.log();
   }
   process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.143",
+  "version": "1.0.144",
   "description": "Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.",
   "author": "ADAC 1001 <info@adac1001.com>",
   "license": "MIT",