cc-dev-template 0.1.8 → 0.1.10

package/bin/install.js

@@ -20,7 +20,7 @@ console.log('='.repeat(50));
 console.log(`Installing to ${CLAUDE_DIR}...`);
 
 // Create directories
-const dirs = ['agents', 'commands', 'scripts', 'skills'];
+const dirs = ['agents', 'commands', 'scripts', 'skills', 'mcp-servers'];
 dirs.forEach(dir => {
   fs.mkdirSync(path.join(CLAUDE_DIR, dir), { recursive: true });
 });
@@ -92,6 +92,75 @@ if (fs.existsSync(skillsDir)) {
   console.log('  No skills to install');
 }
 
+// Install MCP servers
+console.log('\nMCP Servers:');
+const mcpServersDir = path.join(SRC_DIR, 'mcp-servers');
+if (fs.existsSync(mcpServersDir)) {
+  const mcpServers = fs.readdirSync(mcpServersDir, { withFileTypes: true })
+    .filter(d => d.isDirectory());
+
+  mcpServers.forEach(server => {
+    const srcPath = path.join(mcpServersDir, server.name);
+    const destPath = path.join(CLAUDE_DIR, 'mcp-servers', server.name);
+
+    // Copy server files (excluding node_modules and dist)
+    fs.mkdirSync(destPath, { recursive: true });
+    const entries = fs.readdirSync(srcPath, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (entry.name === 'node_modules' || entry.name === 'dist') continue;
+
+      const entrySrc = path.join(srcPath, entry.name);
+      const entryDest = path.join(destPath, entry.name);
+
+      if (entry.isDirectory()) {
+        copyDir(entrySrc, entryDest);
+      } else {
+        fs.copyFileSync(entrySrc, entryDest);
+      }
+    }
+    console.log(`  ${server.name}/ copied`);
+
+    // Install dependencies and build
+    try {
+      console.log(`    Installing dependencies...`);
+      execSync('npm install --silent', {
+        cwd: destPath,
+        stdio: 'pipe'
+      });
+
+      console.log(`    Building...`);
+      execSync('npm run build', {
+        cwd: destPath,
+        stdio: 'pipe'
+      });
+
+      // Register with Claude Code (user-level only)
+      if (!isProjectLevel) {
+        const distPath = path.join(destPath, 'dist', 'index.js');
+        if (fs.existsSync(distPath)) {
+          try {
+            // Check if already registered
+            execSync(`claude mcp remove ${server.name} 2>/dev/null || true`, { stdio: 'pipe' });
+            execSync(`claude mcp add ${server.name} node "${distPath}"`, { stdio: 'pipe' });
+            console.log(`    Registered with Claude Code`);
+          } catch (e) {
+            console.log(`    ⚠ Could not register with Claude Code (run manually: claude mcp add ${server.name} node "${distPath}")`);
+          }
+        }
+      }
+
+      console.log(`  ✓ ${server.name} installed`);
+    } catch (e) {
+      console.log(`  ⚠ Failed to build ${server.name}: ${e.message}`);
+    }
+  });
+
+  console.log(`✓ ${mcpServers.length} MCP server(s) processed`);
+} else {
+  console.log('  No MCP servers to install');
+}
+
 // Create package.json for dependencies
 console.log('\nDependencies:');
 const pkgJson = {
@@ -151,11 +220,12 @@ console.log('Installation complete!');
 console.log('='.repeat(50));
 console.log(`
 Installed to:
-  Agents:   ${CLAUDE_DIR}/agents/
-  Commands: ${CLAUDE_DIR}/commands/
-  Scripts:  ${CLAUDE_DIR}/scripts/
-  Skills:   ${CLAUDE_DIR}/skills/
-  Settings: ${CLAUDE_DIR}/settings.json
+  Agents:      ${CLAUDE_DIR}/agents/
+  Commands:    ${CLAUDE_DIR}/commands/
+  Scripts:     ${CLAUDE_DIR}/scripts/
+  Skills:      ${CLAUDE_DIR}/skills/
+  MCP Servers: ${CLAUDE_DIR}/mcp-servers/
+  Settings:    ${CLAUDE_DIR}/settings.json
 `);
 
 if (isProjectLevel) {
@@ -166,6 +236,12 @@ Claude Code will use project-level settings with user-level as fallback.
 } else {
   console.log(`User-level installation complete.
 These settings are available globally across all your projects.
+
+MCP Server Notes:
+  - qa-server: Spawns a sub-agent for frontend visual inspection
+    Saves ~20k tokens by offloading browser tools to sub-agent
+    If you have chrome-devtools MCP installed, consider removing it:
+    claude mcp remove chrome-devtools
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-dev-template",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Structured AI-assisted development framework for Claude Code",
   "bin": {
     "cc-dev-template": "./bin/install.js"

package/src/agents/claude-md-agent.md

@@ -28,7 +28,7 @@ When given insights to document:
 
 ## ADR vs CLAUDE.md
 
-Reject content that should be an ADR instead.
+Route ADR-worthy content to adr-agent instead.
 
 | CLAUDE.md (Operational How-To) | ADR (Architectural Decision) |
 |-------------------------------|------------------------------|

package/src/agents/execution-agent.md

@@ -130,7 +130,7 @@ The prompting skill ensures your prompts follow established patterns: explaining
 - **Missing Dependency** - Need something from an upstream task that wasn't done
 - **Blocked** - External factor prevents completion (missing API key, service down, etc.)
 
-**Do not try to work around issues.** The plan should have removed all ambiguity. If something is unexpected, escalate.
+**Stop and escalate when unexpected issues arise.** The plan should have removed all ambiguity. If something is unexpected, escalate.
 
 When escalating, report:
 - What you encountered
@@ -145,4 +145,4 @@ When escalating, report:
 
 **Outcome is context** - Write outcomes for the next person (or agent). What did you do? Where are things? What decisions did you make?
 
-**No improvisation** - If the task or plan is unclear, escalate. Don't guess.
+**Escalate when unclear** - If the task or plan is unclear, escalate rather than guessing.

package/src/agents/tdd-agent.md

@@ -156,7 +156,7 @@ Report:
 
 **Tests are specifications.** In fix mode, the test defines correct behavior. Don't question it—make the code conform.
 
-**Fix mode: code only.** Never touch test files in fix mode. If the test is wrong, escalate.
+**Fix mode: code only.** Modify only non-test files in fix mode. If the test is wrong, escalate.
 
 **Test mode: fail is success.** A test that fails (because the bug exists) is exactly what we want. A passing test means the hypothesis is wrong.
 

package/src/mcp-servers/qa-server/README.md

@@ -0,0 +1,120 @@
+# QA Server
+
+MCP server that spawns a Claude sub-agent for frontend visual inspection.
+
+## Problem
+
+Chrome DevTools MCP adds ~20k tokens to context just from tool definitions, even when browser inspection isn't needed. This wastes context in long sessions.
+
+## Solution
+
+This server exposes a single `inspect_frontend` tool (~500 tokens) that spawns a sub-agent with full browser capabilities on-demand.
+
+```
+Main Conversation (~500 tokens)
+    │
+    └── mcp__qa__inspect_frontend
+            │
+            └── Sub-agent with chrome-devtools MCP (full control)
+                    │
+                    └── Returns QA report
+```
+
+## Installation
+
+```bash
+cd src/mcp-servers/qa-server
+npm install
+npm run build
+```
+
+Then add to Claude Code:
+
+```bash
+claude mcp add qa node /path/to/qa-server/dist/index.js
+```
+
+Or in `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "qa": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/path/to/qa-server/dist/index.js"]
+    }
+  }
+}
+```
+
+## After Setup
+
+Remove chrome-devtools from your main config to save tokens:
+
+```bash
+claude mcp remove chrome-devtools
+```
+
+## Usage
+
+From Claude Code conversation:
+
+```
+Inspect http://localhost:3000 and verify the login form works
+```
+
+Claude will call `mcp__qa__inspect_frontend` with:
+- url: "http://localhost:3000"
+- task: "verify the login form works"
+
+The sub-agent will:
+1. Navigate to the URL
+2. Take screenshots
+3. Check console errors
+4. Perform the task (click, fill forms, etc.)
+5. Return a structured QA report
+
+## Tool Definition
+
+```typescript
+{
+  name: "inspect_frontend",
+  description: "Spawn a QA sub-agent to visually inspect a frontend...",
+  inputSchema: {
+    type: "object",
+    properties: {
+      url: { type: "string", description: "URL to inspect" },
+      task: { type: "string", description: "What to inspect or test" }
+    },
+    required: ["url", "task"]
+  }
+}
+```
+
+## Sub-agent Capabilities
+
+The spawned sub-agent uses Opus (best visual understanding) and has access to:
+
+- **Navigation**: navigate_page, new_page, list_pages, select_page, wait_for
+- **Inspection**: take_screenshot, take_snapshot, list_console_messages
+- **Interaction**: click, fill, fill_form, hover, press_key, handle_dialog
+
+## Token Savings
+
+| Before | After |
+|--------|-------|
+| ~20k tokens (26 browser tools always loaded) | ~500 tokens (1 tool) |
+
+## Development
+
+```bash
+# Run in development mode
+npm run dev
+
+# Build for production
+npm run build
+
+# Run production build
+npm start
+```