claude-code-autoconfig 1.0.0

package/.claude/settings.json

@@ -0,0 +1,51 @@
+{
+  "permissions": {
+    "allow": [
+      "Read(./**)",
+      "Edit(./**)",
+      "Write(./**)",
+      "WebSearch",
+      "WebFetch",
+      "Bash(npm run dev)",
+      "Bash(npm run build)",
+      "Bash(npm run lint)",
+      "Bash(npm run lint:fix)",
+      "Bash(npm run typecheck)",
+      "Bash(npm run test)",
+      "Bash(npm run test:*)",
+      "Bash(npm run validate)",
+      "Bash(git status)",
+      "Bash(git diff:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(git pull)",
+      "Bash(git checkout:*)",
+      "Bash(git branch:*)"
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Read(./secrets/**)",
+      "Read(./**/credentials.*)",
+      "Read(./**/*.pem)",
+      "Read(./**/*.key)",
+      "Bash(rm -rf:*)",
+      "Bash(curl:*)",
+      "Bash(wget:*)"
+    ]
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "printf '\\033]0;claude\\007' || true"
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude/settings.local.json

@@ -0,0 +1,19 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "Bash(cat:*)",
+      "Bash(rm:*)",
+      "Bash(del /q \"C:\\\\CODE\\\\claude-code-autoconfig\\\\.claude\\\\retro\\\\_TEMPLATE.md\")",
+      "Bash(git mv:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:agentskills.io)",
+      "Bash(npm link)",
+      "Bash(npm pack:*)",
+      "Bash(npm login)",
+      "Bash(npm login --auth-type=web)",
+      "Bash(npm publish:*)",
+      "Bash(npm config set:*)"
+    ]
+  }
+}

package/CLAUDE.md

@@ -0,0 +1,7 @@
+<!-- AUTO-GENERATED BY /autoconfig — Do not edit. Use .claude/feedback/ for corrections. -->
+
+# Project Name
+
+> Run `/autoconfig` to populate this based on your project.
+
+<!-- END AUTO-GENERATED -->

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ADAC 1001
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# Claude Code Autoconfig
+
+Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.
+
+## Quick Install
+
+**macOS / Linux / WSL:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/design-and-deliver/claude-code-autoconfig/main/install.sh | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/design-and-deliver/claude-code-autoconfig/main/install.ps1 | iex
+```
+
+## After Install
+
+1. **`/autoconfig`** — Claude analyzes your project and configures itself
+2. **`/show-guide`** — Opens an interactive guide showing what got set up
+
+That's it. Your Claude Code environment is configured and ready.
+
+## What Gets Installed
+
+```
+your-project/
+├── CLAUDE.md                          # Project context (auto-populated)
+└── .claude/
+    ├── commands/                      # Slash commands
+    │   ├── autoconfig.md              #   /autoconfig - self-configures
+    │   ├── commit-and-push.md         #   /commit-and-push - git workflow
+    │   ├── enable-retro.md            #   /enable-retro - opt-in tech debt tracking
+    │   ├── show-guide.md              #   /show-guide - interactive walkthrough
+    │   ├── sync-claude-md.md          #   /sync-claude-md - update CLAUDE.md
+    │   └── test.md                    #   /test - run tests
+    ├── feedback/                      # Team corrections for Claude
+    │   └── FEEDBACK.md                #   Add entries when Claude errs
+    ├── guide/                         # Interactive walkthrough
+    │   └── autoconfig.guide.html      #   Open with /show-guide
+    ├── rules/                         # Path-scoped context (empty)
+    ├── .mcp.json                      # MCP server configs (empty placeholder)
+    └── settings.json                  # Permissions & security
+```
+
+## How It Works
+
+### Self-Configuration
+
+Most templates are static — copy, paste, manually fill in.
+
+This one is **self-configuring**. Run `/autoconfig` and Claude:
+
+1. **Detects your environment** — Windows vs macOS/Linux for correct command syntax
+2. **Scans your project** — Package files, framework indicators, test setup
+3. **Populates CLAUDE.md** — Project name, tech stack, commands, conventions
+4. **Configures settings.json** — Permissions tuned to your ecosystem
+
+You get a custom-fit configuration without the manual work.
+
+### Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/autoconfig` | Analyzes project and populates configuration |
+| `/sync-claude-md` | Re-analyzes project and updates CLAUDE.md |
+| `/show-guide` | Opens interactive guide in browser |
+| `/test` | Runs your test suite (auto-detects framework) |
+| `/commit-and-push` | Stages, commits with good message, and pushes |
+| `/enable-retro` | (Experimental) Enable tech debt tracking |
+
+### Team Feedback
+
+When Claude makes a mistake, add an entry to `.claude/feedback/FEEDBACK.md`:
+
+```markdown
+## 2026-01-07: Don't use deprecated API
+Claude used `oldFunction()` instead of `newFunction()`.
+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 is intentionally empty. Effective rules require understanding your codebase patterns, team conventions, and quality standards.
+
+**Want optimized rules for your project?**
+Reach out: [info@adac1001.com](mailto:info@adac1001.com)
+
+## Permissions & Security
+
+The included `settings.json` provides sensible defaults that balance productivity with safety:
+
+- **`allow`** — Auto-approved operations (file edits, tests, git commands)
+- **`deny`** — Always blocked (secrets, destructive commands, network calls)
+
+Review and adjust these for your team's needs. Run `/permissions` in Claude Code to inspect your current configuration.
+
+See [Claude Code Security Docs](https://docs.anthropic.com/en/docs/claude-code/security) for best practices.
+
+## Links
+
+- [Claude Code Docs](https://docs.anthropic.com/en/docs/claude-code/overview)
+- [Slash Commands Reference](https://docs.anthropic.com/en/docs/claude-code/slash-commands)
+
+---
+
+Built by [ADAC 1001](https://adac1001.com)

package/bin/cli.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const cwd = process.cwd();
+const packageDir = path.dirname(__dirname);
+
+console.log('\x1b[36m%s\x1b[0m', '🚀 Installing Claude Code Autoconfig...');
+console.log();
+
+// Files/dirs to skip during copy (project-specific, not for distribution)
+const SKIP_FILES = ['settings.local.json', 'retro'];
+
+// Helper to copy directory recursively
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (SKIP_FILES.includes(entry.name)) continue;
+
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// Copy .claude directory
+const claudeSrc = path.join(packageDir, '.claude');
+const claudeDest = path.join(cwd, '.claude');
+
+if (fs.existsSync(claudeSrc)) {
+  copyDir(claudeSrc, claudeDest);
+  console.log('\x1b[32m%s\x1b[0m', '✅ Created .claude/ directory structure');
+} else {
+  console.log('\x1b[31m%s\x1b[0m', '❌ Error: .claude directory not found in package');
+  process.exit(1);
+}
+
+// Copy CLAUDE.md (don't overwrite if exists)
+const claudeMdSrc = path.join(packageDir, 'CLAUDE.md');
+const claudeMdDest = path.join(cwd, 'CLAUDE.md');
+
+if (fs.existsSync(claudeMdDest)) {
+  console.log('\x1b[33m%s\x1b[0m', '⚠️  CLAUDE.md already exists, saving template as CLAUDE.md.template');
+  fs.copyFileSync(claudeMdSrc, path.join(cwd, 'CLAUDE.md.template'));
+} else if (fs.existsSync(claudeMdSrc)) {
+  fs.copyFileSync(claudeMdSrc, claudeMdDest);
+  console.log('\x1b[32m%s\x1b[0m', '✅ Created CLAUDE.md');
+}
+
+console.log();
+console.log('\x1b[36m%s\x1b[0m', '✨ Claude Code Autoconfig installed!');
+console.log();
+console.log('Once Claude Code is open:');
+console.log('  1. Run \x1b[33m/autoconfig\x1b[0m to configure for your project');
+console.log('  2. Run \x1b[33m/show-guide\x1b[0m to open the interactive guide');
+console.log();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "claude-code-autoconfig",
+  "version": "1.0.0",
+  "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",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/design-and-deliver/claude-code-autoconfig.git"
+  },
+  "homepage": "https://github.com/design-and-deliver/claude-code-autoconfig#readme",
+  "bugs": {
+    "url": "https://github.com/design-and-deliver/claude-code-autoconfig/issues"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "ai",
+    "autoconfig",
+    "configuration",
+    "cli"
+  ],
+  "bin": {
+    "claude-code-autoconfig": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    ".claude",
+    "CLAUDE.md"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}