feat: add LICENSE, CI, CONTRIBUTING, and promote live AI monitor

- Add MIT LICENSE (Copyright 2026 TheDecipherist)
- Add .claude/settings.local.json.example for personal hook overrides
- Add GitHub Actions CI workflow (typecheck + unit tests on PRs)
- Add CONTRIBUTING.md with issue/PR guidelines
- Add "See It In Action" demo placeholder section to README
- Promote /what-is-my-ai-doing in README and docs (dedicated feature
  card, moved to position 3 in commands, added highlight callout)
- Make GitHub Pages link more prominent with blockquote callout
- Add CI status badge to README

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: timclausendev-web

.claude/settings.local.json.example

@@ -0,0 +1,43 @@
+{
+  "_comment": [
+    "Personal hook overrides — copy this file to .claude/settings.local.json",
+    "which is gitignored. Your overrides here won't affect the team config.",
+    "",
+    "To use: cp .claude/settings.local.json.example .claude/settings.local.json",
+    "Then edit .claude/settings.local.json with your personal preferences."
+  ],
+
+  "hooks": {
+    "PreToolUse": [
+      {
+        "_comment": "Example: override the default hook timeout (milliseconds)",
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo 'Pre-write check'",
+            "timeout": 15000
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "_comment": "Example: personal post-tool hook (e.g., notify, log, or format)",
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "date '+%H:%M:%S file written' >> /tmp/claude-hook-log.txt"
+          }
+        ]
+      }
+    ]
+  },
+
+  "env": {
+    "_comment": "Example: personal environment variables for hooks and scripts",
+    "MY_EDITOR": "code",
+    "LINT_ON_SAVE": "true"
+  }
+}

.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - run: pnpm install --frozen-lockfile
+
+      - name: TypeScript type-check
+        run: pnpm typecheck
+
+      - name: Unit tests
+        run: pnpm test:unit

.gitignore

@@ -9,6 +9,7 @@ service-account.json
 
 # Claude Code personal overrides
 CLAUDE.local.md
+.claude/settings.local.json
 
 # Dependencies
 node_modules/

CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing
+
+Thanks for your interest in improving the Claude Code Starter Kit.
+
+## Reporting Issues
+
+Use [GitHub Issues](../../issues). Include:
+- Claude Code version (`claude --version`)
+- OS and environment (macOS, Linux, WSL2)
+- Steps to reproduce
+- Expected vs actual behavior
+
+## Submitting Changes
+
+1. Fork the repo
+2. Create a branch from `main` (`git checkout -b feat/your-change`)
+3. Make your changes
+4. Run `pnpm test` to verify all tests pass
+5. Run the `/review` slash command in Claude Code on every file you changed
+6. Open a PR against `main`
+
+## What's Welcome
+
+- New slash commands (`.claude/commands/`)
+- New skills (`.claude/skills/`)
+- New hooks (`.claude/hooks/`)
+- Documentation improvements
+- Bug fixes
+- Test coverage improvements
+
+## What's NOT Welcome
+
+- Framework-specific opinions — keep it stack-agnostic where possible
+- Removing existing rules without discussion — open an issue first
+- Large refactors without a prior issue/discussion
+
+## Code Style
+
+- TypeScript strict mode for all new files
+- Follow the existing patterns in the project
+- No file > 300 lines, no function > 50 lines
+- Run `/review` before submitting your PR
+- See `CLAUDE.md` for the full coding standards
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the same license as this project (see [LICENSE](LICENSE)).
+
+## Credit
+
+Contributors are acknowledged in README.md and the [GitHub Pages site](https://thedecipherist.github.io/claude-code-mastery-project-starter-kit/).
+
+## Context
+
+This project implements patterns from the [Claude Code Mastery Guide](https://github.com/TheDecipherist/claude-code-mastery). Understanding V3-V5 helps explain why rules exist the way they do.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TheDecipherist
+
+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.

README.md

@@ -1,6 +1,10 @@
 # Claude Code Starter Kit
 
-### [View the Full Interactive Guide →](https://thedecipherist.github.io/claude-code-mastery-project-starter-kit/)
+[![CI](https://github.com/TheDecipherist/claude-code-mastery-project-starter-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/TheDecipherist/claude-code-mastery-project-starter-kit/actions/workflows/ci.yml)
+
+> ## [View the Full Interactive Guide →](https://thedecipherist.github.io/claude-code-mastery-project-starter-kit/)
+>
+> The GitHub Pages site has the complete documentation with syntax highlighting, navigation, and visual examples. The README below is a summary.
 
 > The definitive starting point for Claude Code projects.
 > Based on [Claude Code Mastery Guides V3-V5](https://github.com/TheDecipherist/claude-code-mastery) by TheDecipherist.
@@ -11,6 +15,16 @@
 
 This is a **ready-to-use project template** that bakes in every best practice from the Claude Code Mastery Guide series (V3, V4, and V5). Instead of reading 4,000+ lines of guides and setting things up yourself, clone this and start building.
 
+## See It In Action
+
+<!-- Record with: asciinema rec demo.cast && agg demo.cast docs/demo.gif -->
+![Starter Kit Demo](docs/demo.gif)
+
+*Clone → `/setup` → `/diagram all` → hooks firing on file edit → `/review` catching issues*
+
+<!-- Capture /progress output as a screenshot -->
+![Slash Commands](docs/commands-preview.png)
+
 ## What's Included
 
 ### 📄 CLAUDE.md (Project Instructions)
@@ -28,6 +42,9 @@ Security gatekeeper that applies to ALL your projects:
 - New project scaffolding standards
 - Copy `global-claude-md/` contents to `~/.claude/`
 
+### 📡 Live AI Monitor
+See every tool call, token, cost, and violation in real-time with `/what-is-my-ai-doing`. Zero token overhead — runs completely outside Claude's context.
+
 ### 🪝 Hooks (Deterministic Enforcement)
 CLAUDE.md rules are suggestions. Hooks are guarantees:
 - **block-secrets.py** — Prevents reading .env, credentials, SSH keys
@@ -36,6 +53,9 @@ CLAUDE.md rules are suggestions. Hooks are guarantees:
 
 ### ⚡ Commands (Slash Commands)
 On-demand tools you invoke with `/command`:
+- `/setup` — Interactive .env configuration (database, GitHub, Docker, analytics)
+- `/diagram` — Auto-generate architecture, API, database, and infrastructure diagrams
+- `/what-is-my-ai-doing` — Live monitor of every tool call, token, cost, and violation in real-time
 - `/review` — Code review with security, performance, and type safety checks
 - `/commit` — Smart commit with conventional commit format
 - `/progress` — Real-time project status from filesystem state

docs/index.html

@@ -246,6 +246,14 @@ <h3>Documentation</h3>
             <h3>Testing Templates</h3>
             <p>Master test checklist, issue tracking log, and a singleton database wrapper that prevents connection pool explosion. All inputs are auto-sanitized against NoSQL injection.</p>
           </div>
+
+          <div class="feature-card">
+            <div class="feature-icon feature-icon-amber">
+              <svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="3" width="20" height="14" rx="2" ry="2"/><line x1="8" y1="21" x2="16" y2="21"/><line x1="12" y1="17" x2="12" y2="21"/></svg>
+            </div>
+            <h3>Live AI Monitor</h3>
+            <p>See every tool call, token, cost, and violation in real-time with <code>/what-is-my-ai-doing</code>. Zero token overhead &mdash; runs completely outside Claude's context.</p>
+          </div>
         </div>
       </section>
 
@@ -729,6 +737,10 @@ <h3>Hook Configuration</h3>
         <h2>Slash Commands &mdash; On-Demand Tools</h2>
         <p>Invoke these with <code>/command</code> in any Claude Code session. Each command is a markdown file in <code>.claude/commands/</code> that gives Claude specific instructions and tool permissions.</p>
 
+        <div class="callout" style="background: var(--bg-secondary); border-left: 4px solid var(--accent-amber); padding: 1rem 1.25rem; border-radius: 0.5rem; margin-bottom: 1.5rem;">
+          <strong>New:</strong> See everything your AI does in real-time &rarr; <code>/what-is-my-ai-doing</code>
+        </div>
+
         <div class="commands-grid">
           <div class="command-card">
             <h3><code>/diagram</code></h3>
@@ -771,6 +783,20 @@ <h3><code>/setup</code></h3>
             <p>Skips variables that already have values. Use <code>/setup --reset</code> to re-configure everything. Never displays secrets back to you. Keeps <code>.env.example</code> in sync.</p>
           </div>
 
+          <div class="command-card">
+            <h3><code>/what-is-my-ai-doing</code></h3>
+            <p class="command-desc">Launches the RuleCatch AI-Pooler live monitor in a separate terminal. See everything your AI is doing in real time:</p>
+            <ul>
+              <li>Every tool call (Read, Write, Edit, Bash)</li>
+              <li>Token usage and cost per turn</li>
+              <li>Rule violations as they happen</li>
+              <li>Which files are being accessed</li>
+            </ul>
+            <pre class="language-bash"><code class="language-bash"># Run in a separate terminal
+npx @rulecatch/ai-pooler@latest monitor -v</code></pre>
+            <p>Zero token overhead &mdash; runs completely outside Claude's context. Also available as <code>pnpm ai:monitor</code>.</p>
+          </div>
+
           <div class="command-card">
             <h3><code>/review</code></h3>
             <p class="command-desc">Systematic code review against a 7-point checklist:</p>
@@ -825,20 +851,6 @@ <h3><code>/architecture</code></h3>
             <p class="command-desc">Reads <code>project-docs/ARCHITECTURE.md</code> and displays the system overview, data flow diagrams, and service responsibility maps. If docs don't exist, scaffolds them.</p>
           </div>
 
-          <div class="command-card">
-            <h3><code>/what-is-my-ai-doing</code></h3>
-            <p class="command-desc">Launches the RuleCatch AI-Pooler live monitor in a separate terminal. See everything your AI is doing in real time:</p>
-            <ul>
-              <li>Every tool call (Read, Write, Edit, Bash)</li>
-              <li>Token usage and cost per turn</li>
-              <li>Rule violations as they happen</li>
-              <li>Which files are being accessed</li>
-            </ul>
-            <pre class="language-bash"><code class="language-bash"># Run in a separate terminal
-npx @rulecatch/ai-pooler@latest monitor -v</code></pre>
-            <p>Zero token overhead &mdash; runs completely outside Claude's context. Also available as <code>pnpm ai:monitor</code>.</p>
-          </div>
-
           <div class="command-card">
             <h3><code>/worktree</code></h3>
             <p class="command-desc">Creates an isolated git worktree + branch for a task:</p>