claude-code-autoconfig 1.0.183 → 1.0.185

package/.claude/agents/README.md

@@ -0,0 +1,10 @@
+<!-- @description Placeholder — drop your project's custom subagent definitions in this directory. -->
+
+# Agents
+
+This directory is where you define **subagents** — focused assistants Claude can delegate to during a task (e.g., a code reviewer, a test writer, a security auditor).
+
+claude-code-autoconfig ships this folder empty so you can populate it with agents tuned to your project. Each agent is a single Markdown file with frontmatter describing its purpose, tools, and system prompt.
+
+See Anthropic's subagents docs for the file format:
+https://docs.anthropic.com/en/docs/claude-code/sub-agents

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

@@ -878,11 +878,6 @@
                                 <span class="tree-file-icon">📄</span>
                                 <span class="file">commit-and-push.md</span>
                             </div>
-                            <div class="tree-item indent-3 hidden" data-info="enable-retro" data-parent="commands">
-                                <span class="tree-spacer"></span>
-                                <span class="tree-file-icon">📄</span>
-                                <span class="file">enable-retro.md</span>
-                            </div>
                             <div class="tree-item indent-3 hidden" data-info="extract-rules" data-parent="commands">
                                 <span class="tree-spacer"></span>
                                 <span class="tree-file-icon">📄</span>
@@ -923,15 +918,10 @@
                                 <span class="tree-folder-icon">📁</span>
                                 <span class="folder">agents</span>
                             </div>
-                            <div class="tree-item indent-3 hidden" data-info="create-retro-item-agent" data-parent="agents">
+                            <div class="tree-item indent-3 hidden" data-info="README-agent" data-parent="agents">
                                 <span class="tree-spacer"></span>
                                 <span class="tree-file-icon">📄</span>
-                                <span class="file">create-retro-item.md</span>
-                            </div>
-                            <div class="tree-item indent-3 hidden" data-info="docs-refresh-agent" data-parent="agents">
-                                <span class="tree-spacer"></span>
-                                <span class="tree-file-icon">📄</span>
-                                <span class="file">docs-refresh.md</span>
+                                <span class="file">README.md</span>
                             </div>
                             <div class="tree-item indent-2 folder-row hidden collapsed" data-info="feedback" data-folder="feedback" data-parent="claude-dir">
                                 <span class="tree-chevron">›</span>
@@ -1268,7 +1258,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.'
             },
@@ -1303,11 +1293,6 @@
                 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="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Changes committed and pushed to current branch.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>test-failure</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">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.<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="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">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'
-            },
             'extract-rules': {
                 title: 'extract-rules.md',
                 desc: 'Scan Claude artifacts and extract structured rules into .claude/rules/<div style="margin-top: 12px;"><strong>Parameters</strong><table style="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Name</th><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Type</th><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Required</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>select</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>string</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Write only specific rules by number: "1,3,5". Default: all.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>keep-sources</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>boolean</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Write rules but skip source cleanup (Step 8)</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Rules extracted, written, and sources cleaned up.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>no-rules</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">No extractable rules found in scanned sources.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Creates .claude/rules/ files and removes extracted content from source files</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>/extract-rules</code> <span style="opacity: 0.6;">— Scan, propose, prompt for approval, write, and clean up</span></div><div><code>/extract-rules --keep-sources</code> <span style="opacity: 0.6;">— Write rules without modifying source files</span></div><div><code>/extract-rules --select 1,3</code> <span style="opacity: 0.6;">— Write only rules #1 and #3</span></div></div></div>',
@@ -1343,14 +1328,9 @@
                 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="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>valid</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Install validated — all checks passed.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>issues</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">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': {
-                title: 'create-retro-item.md',
-                desc: 'Creates a formatted retro item when tech debt or improvements are spotted.',
-                trigger: 'Background agent'
-            },
-            'docs-refresh-agent': {
-                title: 'docs-refresh.md',
-                desc: 'Background worker that syncs the docs when .claude/ files change.',
+            'README-agent': {
+                title: 'README.md',
+                desc: 'Placeholder — drop your project\'s custom subagent definitions in this directory.',
                 trigger: 'Background agent'
             },
             'feedback-rule-check-hook': {
@@ -1579,7 +1559,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
 -->
@@ -1666,39 +1646,6 @@ Use conventional commits: \`type(scope): description\`
 Types: feat, fix, docs, style, refactor, test, chore
 
 Keep the subject line under 50 chars. Add body if the change needs explanation.`
-            },
-            'enable-retro': {
-                filename: 'enable-retro.md',
-                content: `# Enable Retro
-
-Enable the experimental Retro feature, which lets Claude log tech debt and improvement opportunities as structured story files.
-
-## What This Does
-
-1. Creates \`.claude/retro/\` directory with a README
-2. Creates \`.claude/agents/create-retro-item.md\` agent
-3. Adds Retro instructions to CLAUDE.md
-
-## Step 1: Create Retro Directory
-
-Create \`.claude/retro/README.md\` with:
-
-\`\`\`markdown
-# Retro Items
-
-Tech debt and improvement opportunities identified during development.
-
-Each item is a structured story file with:
-- Problem description
-- Acceptance criteria
-- Suggested approach
-- Priority & effort sizing
-- Files involved
-
-## Working with Retro Items
-
-- "Fix retro #001" — Work on a specific item
-- "What's in the retro backlog?" — List pending items`
             },
             'extract-rules': {
                 filename: 'extract-rules.md',
@@ -1900,60 +1847,16 @@ echo "$TMPDIR/package"
 
 Store the extracted path as \`$PKG_DIR\`. This gives us the ground truth for what files and versions should be installed.`
             },
-            'create-retro-item-agent': {
-                filename: 'create-retro-item.md',
-                content: `# Create Retro Item Agent
-
-Create a fully-scoped story file in \`.claude/retro/\` when tech debt or improvement opportunities are identified.
-
-## When to Trigger
-
-Call this agent when you notice:
-- Tech debt that should be addressed later
-- Code that works but could be improved
-- Missing tests, documentation, or error handling
-- Architectural improvements worth tracking
-
-## Input
-
-Provide these details when calling:
-- **title**: Short descriptive name (used for filename)
-- **problem**: What's wrong or what friction was encountered
-- **criteria**: Specific, testable acceptance criteria
-- **approach**: How to fix it
-- **priority**: Critical | High | Medium | Low
-- **effort**: S | M | L | XL
-- **files**: List of files involved
-
-## Behavior
-
-1. Generate filename from title: \`kebab-case.md\`
-2. Create story file in \`.claude/retro/\` using this format:
-
-\`\`\`markdown
-# [Title]`
-            },
-            'docs-refresh-agent': {
-                filename: 'docs-refresh.md',
-                content: `# Docs Refresh Agent
-
-Sync the interactive docs with the current state of \`.claude/\`.
-
-## How
-
-Run:
-
-\`\`\`bash
-node .claude/scripts/sync-docs.js
-\`\`\`
+            'README-agent': {
+                filename: 'README.md',
+                content: `# Agents
 
-This scans \`.claude/\` for all files, extracts \`@description\` metadata, and updates the docs HTML (file tree, info cards, and content previews).
+This directory is where you define **subagents** — focused assistants Claude can delegate to during a task (e.g., a code reviewer, a test writer, a security auditor).
 
-## When to Use
+claude-code-autoconfig ships this folder empty so you can populate it with agents tuned to your project. Each agent is a single Markdown file with frontmatter describing its purpose, tools, and system prompt.
 
-- After adding, modifying, or deleting files in \`.claude/\`
-- Before opening docs with \`/show-docs\` (already built in)
-- As a background task when \`.claude/\` files change`
+See Anthropic's subagents docs for the file format:
+https://docs.anthropic.com/en/docs/claude-code/sub-agents`
             },
             'feedback-rule-check-hook': {
                 filename: 'feedback-rule-check.js',

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

@@ -25,7 +25,7 @@ if (!fs.existsSync(docsPath)) {
 
 // Directories/files to skip entirely
 const SKIP = new Set([
-  'docs', 'plans', 'migration', 'retro', 'scripts',
+  'docs', 'plans', 'migration', 'scripts',
   'settings.local.json'
 ]);
 

package/CHANGELOG.md

@@ -141,9 +141,3 @@
 ## v1.0.136
 - fix: modernize permission syntax and merge perms on upgrade
 
-## v1.0.135
-- feat: auto-sync docs with .claude/ contents via sync-docs.js
-
-## v1.0.134
-- fix: add missing hooks/updates to docs, expand sync tests
-

package/README.md

@@ -48,16 +48,14 @@ your-project/
     │   ├── autoconfig.md              #   /autoconfig - self-configures
     │   ├── autoconfig-update.md       #   /autoconfig-update - install updates
     │   ├── commit-and-push.md         #   /commit-and-push - git workflow
-    │   ├── enable-retro.md            #   /enable-retro - opt-in tech debt tracking
     │   ├── extract-rules.md            #   /extract-rules - scan & extract rules
     │   ├── gls.md                     #   /gls - view latest screenshot
     │   ├── recover-context.md         #   /recover-context - restore context after compaction
     │   ├── show-docs.md               #   /show-docs - interactive walkthrough
     │   ├── test.md                    #   /test - run tests
     │   └── validate-cca-install.md   #   /validate-cca-install - verify installation
-    ├── agents/                        # Agent definitions
-    │   ├── create-retro-item.md       #   Retro item creation agent
-    │   └── docs-refresh.md            #   Docs sync agent
+    ├── agents/                        # Custom subagents (add your own)
+    │   └── README.md                  #   How to define agents
     ├── feedback/                      # Team corrections for Claude
     │   └── FEEDBACK.md                #   Add entries when Claude errs
     ├── hooks/                         # Hook scripts
@@ -110,7 +108,6 @@ Autoconfig is **self-configuring**. Run `/autoconfig` and Claude:
 | `/gls` | Views latest screenshot for visual context |
 | `/validate-cca-install` | Validates installation against latest published version |
 | `/extract-rules` | Scan Claude artifacts and extract structured rules |
-| `/enable-retro` | (Experimental) Enable tech debt tracking |
 
 ### Updates
 
@@ -144,19 +141,6 @@ Always use the v2 API for user endpoints.
 
 Claude reads this directory and learns for next time. Persists across `/autoconfig` runs.
 
-### Retro Items (Experimental)
-
-Opt-in feature for tracking tech debt. Run `/enable-retro` to activate.
-
-When enabled, Claude logs improvement opportunities as structured story files in `.claude/retro/`:
-- Problem description
-- Acceptance criteria
-- Suggested approach
-- Priority & effort sizing
-- Files involved
-
-Work through items anytime: *"Hey Claude, fix retro #001"*
-
 ### Rules
 
 The `rules/` directory contains path-scoped context rules that activate when Claude edits matching files. Autoconfig ships with publish-safety rules; you can add your own or use `/extract-rules` to generate rules from existing Claude artifacts.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.183",
+  "version": "1.0.185",
   "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",

package/.claude/agents/create-retro-item.md

@@ -1,62 +0,0 @@
-<!-- @description Creates a formatted retro item when tech debt or improvements are spotted. -->
-
-# Create Retro Item Agent
-
-Create a fully-scoped story file in `.claude/retro/` when tech debt or improvement opportunities are identified.
-
-## When to Trigger
-
-Call this agent when you notice:
-- Tech debt that should be addressed later
-- Code that works but could be improved
-- Missing tests, documentation, or error handling
-- Architectural improvements worth tracking
-
-## Input
-
-Provide these details when calling:
-- **title**: Short descriptive name (used for filename)
-- **problem**: What's wrong or what friction was encountered
-- **criteria**: Specific, testable acceptance criteria
-- **approach**: How to fix it
-- **priority**: Critical | High | Medium | Low
-- **effort**: S | M | L | XL
-- **files**: List of files involved
-
-## Behavior
-
-1. Generate filename from title: `kebab-case.md`
-2. Create story file in `.claude/retro/` using this format:
-
-```markdown
-# [Title]
-
-## Problem
-[Problem description]
-
-## Acceptance Criteria
-- [ ] [Criteria 1]
-- [ ] [Criteria 2]
-
-## Approach
-[How to fix]
-
-## Priority
-[Priority level]
-
-## Effort
-[Effort size]
-
-## Files
-- [file1]
-- [file2]
-```
-
-3. Confirm creation with filename
-
-## Guidelines
-
-- **Be concise**: Keep descriptions actionable, not verbose
-- **Be specific**: Include actual file paths and line numbers when relevant
-- **Don't duplicate**: Check if similar item already exists first
-- **Don't block**: Create the item and continue with the main task

package/.claude/agents/docs-refresh.md

@@ -1,21 +0,0 @@
-<!-- @description Background worker that syncs the docs when .claude/ files change. -->
-
-# Docs Refresh Agent
-
-Sync the interactive docs with the current state of `.claude/`.
-
-## How
-
-Run:
-
-```bash
-node .claude/scripts/sync-docs.js
-```
-
-This scans `.claude/` for all files, extracts `@description` metadata, and updates the docs HTML (file tree, info cards, and content previews).
-
-## When to Use
-
-- After adding, modifying, or deleting files in `.claude/`
-- Before opening docs with `/show-docs` (already built in)
-- As a background task when `.claude/` files change

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

@@ -1,58 +0,0 @@
-<!-- @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
-
-Enable the experimental Retro feature, which lets Claude log tech debt and improvement opportunities as structured story files.
-
-## What This Does
-
-1. Creates `.claude/retro/` directory with a README
-2. Creates `.claude/agents/create-retro-item.md` agent
-3. Adds Retro instructions to CLAUDE.md
-
-## Step 1: Create Retro Directory
-
-Create `.claude/retro/README.md` with:
-
-```markdown
-# Retro Items
-
-Tech debt and improvement opportunities identified during development.
-
-Each item is a structured story file with:
-- Problem description
-- Acceptance criteria
-- Suggested approach
-- Priority & effort sizing
-- Files involved
-
-## Working with Retro Items
-
-- "Fix retro #001" — Work on a specific item
-- "What's in the retro backlog?" — List pending items
-- Items are numbered sequentially (001, 002, etc.)
-```
-
-## Step 2: Create Retro Agent
-
-Create `.claude/agents/create-retro-item.md` with the standard retro item agent that:
-- Scans for highest existing ID
-- Creates numbered story files (001-title.md, 002-title.md)
-- Uses structured format: Problem, Acceptance Criteria, Approach, Priority, Effort, Files
-
-## Step 3: Update CLAUDE.md
-
-Add the following section to CLAUDE.md (before Team Feedback if present):
-
-```markdown
-## Retro
-After completing tasks, if you encountered friction, tech debt, or improvement opportunities worth revisiting, use the create-retro-item agent to log it in `.claude/retro/`. Use your judgment on what's worth capturing — not everything needs a retro item.
-```
-
-## Step 4: Confirm
-
-Output: "Retro enabled. Claude will now log tech debt to .claude/retro/ when appropriate."