claude-code-autoconfig 1.0.20 → 1.0.22

package/.claude/agents/AGENTS.md

@@ -0,0 +1,29 @@
+# Subagents
+
+Define autonomous background workers here. Each .md file becomes a subagent Claude can spawn.
+
+<!-- ╔══════════════════════════════════════════════════════════════════╗
+     ║                                                                  ║
+     ║   TEMPLATE BELOW — DELETE THIS BLOCK WHEN ADDING REAL AGENTS     ║
+     ║                                                                  ║
+     ╠══════════════════════════════════════════════════════════════════╣
+     ║                                                                  ║
+     ║   ## agent-name.md                                               ║
+     ║                                                                  ║
+     ║   <!-- Brief description for guide hover -->                     ║
+     ║                                                                  ║
+     ║   # Agent Name                                                   ║
+     ║                                                                  ║
+     ║   Describe what this agent does, when it runs,                   ║
+     ║   and what it has access to.                                     ║
+     ║                                                                  ║
+     ║   ## Trigger                                                     ║
+     ║   - Via hook (PostToolUse, Stop, etc.)                           ║
+     ║   - Via slash command                                            ║
+     ║   - Via another agent                                            ║
+     ║                                                                  ║
+     ║   ## Scope                                                       ║
+     ║   What files/directories can this agent access?                  ║
+     ║   What actions can it take?                                      ║
+     ║                                                                  ║
+     ╚══════════════════════════════════════════════════════════════════╝ -->

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

@@ -0,0 +1,62 @@
+<!-- @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/guide-refresh.md

@@ -0,0 +1,29 @@
+<!-- @description Background worker that syncs the guide when .claude/ files change. -->
+
+# Guide Refresh Agent
+
+Incrementally update the guide's treeInfo when `.claude/` files are added or modified.
+
+## Trigger
+
+- PostToolUse hook on Edit|Write to `.claude/`
+
+## Scope
+
+- Read `.claude/**/*.md` for `@description` comments
+- Update `.claude/guide/autoconfig.guide.html` treeInfo
+
+## Behavior
+
+1. Check which `.claude/` file was just modified
+2. Extract the `<!-- @description ... -->` comment from the top
+3. Find the corresponding entry in the guide's `treeInfo` object
+4. Update only that entry's `desc` field
+5. If file is new, add a new treeInfo entry
+6. If file was deleted, remove the treeInfo entry
+
+## Guidelines
+
+- **Be fast**: Only touch the affected entry
+- **Be minimal**: Don't reformat or reorganize unrelated code
+- **Be silent**: Run in background, no output unless error

package/.claude/commands/autoconfig.md

@@ -181,7 +181,7 @@ del nul 2>nul
 
 This is safe to run even if the file doesn't exist.
 
-### Open Guide
+### Open Guide & Finale
 
 Open the interactive guide in the user's browser:
 
@@ -189,4 +189,12 @@ Open the interactive guide in the user's browser:
 - Linux: `xdg-open .claude/guide/autoconfig.guide.html`
 - Windows: `start .claude/guide/autoconfig.guide.html`
 
-This shows the user what got installed and how to use it.
+Then output a celebratory finale message:
+
+```
+---
+
+✅ Setup complete! Your Claude Code environment is ready.
+
+📖 The interactive guide is now open — it walks through everything that was configured.
+```

package/.claude/settings.local.json

@@ -7,7 +7,8 @@
       "Bash(del /q \"C:\\\\CODE\\\\claude-code-autoconfig\\\\.claude\\\\retro\\\\_TEMPLATE.md\")",
       "Bash(git mv:*)",
       "WebFetch(domain:github.com)",
-      "Bash(npm publish:*)"
+      "Bash(npm publish:*)",
+      "Bash(git ls-tree:*)"
     ]
   }
 }

package/package.json

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