Releases: TheDecipherist/claude-code-mastery-project-starter-kit
Releases · TheDecipherist/claude-code-mastery-project-starter-kit
Release list
v1.3.1 — MDD installs automatically with the starter kit
v1.3.1
Small but important: MDD now installs automatically when you run init or update.
Previously, installing the starter kit and installing MDD were two separate steps. Now they're one:
npx @claude-code-mastery/starter-kit initThis runs the starter kit install as before, then automatically runs:
npm install -g @thedecipherist/mdd
mdd installThe /mdd command is now available in Claude Code immediately after init — no separate step needed.
update also picks this up — running npx @claude-code-mastery/starter-kit update (or /starter-kit update from Claude Code) will update both the starter kit and MDD in one pass.
If either MDD step fails for any reason, a fallback message is shown with the manual command.
See v1.3.0 for the full changelog covering 25 skills, the npm package launch, and all MDD additions.
v1.3.0 — npm Package, 25 Skills, MDD Standalone, Ops Mode
Claude Code Mastery Project Starter Kit v1.3.0
A lot happened since v1.2.0. The three biggest changes: the kit is now on npm, MDD was extracted into its own package, and skills grew from 2 to 25.
npm Package
Install once globally — commands, hooks, and skills work in every Claude Code session without cloning or staying in a specific directory.
npx @claude-code-mastery/starter-kit initAfter init, everything lives in ~/.claude/starter-kit/ and is symlinked into the directories Claude Code already scans. Update anytime with npx @claude-code-mastery/starter-kit update or /starter-kit update from inside Claude Code.
Skills: 2 → 25
The starter kit now ships 25 skills covering the things Claude reliably gets wrong in specific domains. Skills load automatically when Claude detects relevant keywords in conversation — no invocation needed.
| Skill | What it fixes |
|---|---|
| Accessibility | Clickable divs, missing labels, removed focus rings, no ARIA discipline |
| API Conventions | Handler/adapter/server separation drift |
| Code Review | Systematic 7-point checklist with severity ratings |
| Create Service | Full microservice scaffold with server/handlers/adapters |
| CSS Structure | Inline style dumps instead of external .css files |
| Debugger | Symptom fixes instead of root-cause diagnosis |
| Dependency Vetting | No supply-chain check before install |
| Design Review | Usability, accessibility, and visual feedback on UI |
| Dev Pitfalls | WSL filesystem, CRLF, import case, misleading ENOSPC errors |
| Docker | Multi-stage builds, exec-form ENTRYPOINT, healthchecks, non-root |
| Docker Swarm | What breaks when compose goes to Swarm — deploy block, overlays, signals |
| MCP Builder | MCP server development patterns and tool registration |
| MDD Workflow | Keeps .mdd/ docs in sync with code changes |
| MongoDB Backup | Streaming to S3, --nsInclude trap, collection tiering |
| MongoDB Replica Sets | Quorum, WiredTiger sizing, ingress-mode port trap |
| MongoDB Rules | StrictDB and native driver anti-pattern prevention |
| NGINX | Docker DNS resolver, proxy caching, stream block placement |
| Node.js | Graceful shutdown, crash-on-fault, event loop blocking, modern built-ins |
| Responsive CSS | min-width:0 overflow fix, clamp() fluid type, mobile-first |
| Schema Source of Truth | One Zod schema per entity, derived across all layers |
| Terminal TUI | Ink + React TUI patterns, resize handling, keyboard input |
| Test Writer | Explicit assertions, realistic data, 3-assertion minimum |
| WAF | Proactively recommends WAF on deploy; CRS tuning, DetectionOnly rollout |
| Web Architecture | SSR/SSG/CSR decision up front; when to reach for a framework |
| Web Performance | Load strategy as a design decision: inline, preload, defer, lazy-load |
MDD — Now a Standalone Package
MDD (Manual-Driven Development) was extracted from the starter kit into its own npm package so it can be used in any project independently.
npm install -g @thedecipherist/mdd && mdd installOr from Claude Code: /install-global mdd
New MDD modes added since v1.2.0:
- Ops Mode — deployment runbooks with canary-gated execution. Write a runbook once with
/mdd ops, replay it with/mdd runop - Waves — initiative/wave planning system for breaking large initiatives into scoped, demoable chunks (
/mdd plan-initiative,/mdd plan-wave,/mdd plan-execute) - Scan / Update / Deprecate — frontmatter lifecycle management
- Reverse-Engineer / Graph — derive MDD docs from existing code
- Upgrade Mode — batch frontmatter migration for legacy docs
- Task Type — frozen task docs with upgrade patches
- Parallel Agents — audit, scan, and reverse-engineer modes now fan out across docs concurrently
Hooks
10 hooks now (was 9). Changes since v1.2.0:
block-dangerous-bash.py(renamed fromblock-secrets.py) — fires on the Bash tool, not Write/Edit. Catches destructive shell commands earliercheck-file-length.py— new hook that fires after Write/Edit; warns when a file exceeds 300 linescheck-branch.sh— improved cross-repo detection; no longer false-positives when Claude runs git commands against other reposcheck-rybbit.sh— narrowed to actual deployment commands only; no longer fires on writing deploy-related documentation
Commands
Still 27 commands. Notable improvements:
/install-global mdd— installs or updates the MDD package globally in one step/install-mdd [path]— scaffolds.mdd/into any existing project/new-project— skips.claude/copy for npm users (it already lives globally)/show-user-guide— opens the online docs URL; no longer assumes a local file path
What's Included
| Category | Count |
|---|---|
| Slash commands | 27 (16 project + 11 kit management) |
| Hooks | 10 |
| Skills | 25 |
| Agents | 2 |
| Project profiles | 4 (clean, node, go, python) |
Links
- npm package —
@claude-code-mastery/starter-kit - Interactive User Guide
- MDD Package — standalone, use in any project
- RuleCatch.ai — AI monitoring and violation tracking (optional)
v1.2.0 — /add-feature Command + Feature Manifest + Batch Scaffolding
Claude Code Mastery Project Starter Kit v1.2.0
New /add-feature command, a feature manifest system for smarter updates, and a batch scaffold script for the default profile — now at 26 slash commands.
New Command
/add-feature <name>— Add capabilities to an existing project after scaffolding. Supports:mongo,postgres,docker,vitest,playwright,content. Idempotent — safely updates already-installed features. Use--listto see all available features.
Feature Manifest System
Every project now gets a .claude/features.json manifest tracking what's installed. This enables:
/update-projectnow syncs feature source files (e.g., MongoDB wrapper bug fixes) — not just.claude/infrastructure/add-featurereads the manifest to detect already-installed features and offer updates- Legacy projects get auto-detection:
/update-projectscans for known files and offers to write a manifest
Batch Scaffold Script
scaffold-default.sh— Creates a full default-profile project (Next.js + MongoDB + Tailwind + Docker + SEO + CI) in ~3 seconds with progress indicators. Creates 67 files including all configs, database wrapper, query system, Dockerfile, CI workflow, and populated feature manifest.- Matches the existing
scaffold-clean.shpattern but for the complete default stack
Enhanced /update-project
- Step 3b — Feature File Inventory: reads the manifest, compares source vs target feature files, shows UPDATED/UNCHANGED/NEW/CUSTOM status per feature
- Step 5d — Feature File Updates: syncs changed feature files and updates manifest timestamps
- Summary now includes feature file counts
Updated Commands
/new-project— Now writes feature manifests after scaffolding, referencesscaffold-default.shfor default profile/convert-project-to-starter-kit— New Step 7b auto-detects features and generates manifestscaffold-clean.sh— Now creates empty feature manifest
What's Included
| Category | Count | Details |
|---|---|---|
| Commands | 26 | 16 project + 10 kit management |
| Hooks | 9 | Secrets, branch, lint, ports, rybbit, e2e, env-sync, rulecatch |
| Skills | 2 | Code review + service scaffolding |
| Agents | 2 | Code reviewer + test writer |
| Profiles | 15 | JS/TS, Go, Python, Vue, Nuxt, Svelte, Angular, Django, Flask, clean |
| Batch Scripts | 2 | scaffold-clean.sh + scaffold-default.sh |
Upgrade Existing Projects
# From the starter kit directory:
/update-project # Sync infrastructure + feature files
/add-feature mongo # Add MongoDB to a clean project
/add-feature --list # See all available featuresLinks
- Interactive User Guide
- GitHub Pages Documentation
- Claude Code Mastery Guide — the complete guide series (V1-V5)
- RuleCatch.ai — AI monitoring, violation tracking, dashboards (optional)
v1.1.0 — Update Project Command + Interactive User Guide
Claude Code Mastery Project Starter Kit v1.1.0
Two new commands, an interactive User Guide, and hook reliability fixes — now at 25 slash commands.
New Commands
/update-project— Smart-merge the latest starter kit into existing projects. Picks from registered projects, shows a diff report (NEW / UPDATED / UNCHANGED / CUSTOM), creates a safety commit before applying. Undo withgit revert HEAD./show-user-guide— Opens the interactive User Guide in your browser (GitHub Pages or local fallback).
New Documentation
- Interactive User Guide (
docs/user-guide.html) — Complete walkthrough with live examples: installation, first project, commands deep dive, hooks reference, profiles, FAQ. Published on GitHub Pages.
Hook Fixes
- check-branch.sh — Fixed false positives when scaffolding projects outside the starter kit repo (
git -Cdetection + initial commit allowance) - check-rybbit.sh — Fixed false positives on file content containing deployment keywords (now only matches actual deployment commands)
- block-secrets.py — Improved handling during
/new-projectscaffolding
What's Included
| Category | Count | Details |
|---|---|---|
| Commands | 25 | Setup, code quality, git, API, scaffolding, docs, monitoring |
| Hooks | 9 | Secrets, branch, lint, ports, rybbit, e2e, env-sync, rulecatch |
| Skills | 2 | Code review + service scaffolding |
| Agents | 2 | Code reviewer + test writer |
| Profiles | 15 | JS/TS, Go, Python, Vue, Nuxt, Svelte, Angular, Django, Flask, clean |
Upgrade Existing Projects
# From the starter kit directory:
/update-project
# Pick your project → review diff → applyLinks
- Interactive User Guide
- GitHub Pages Documentation
- Claude Code Mastery Guide — the complete guide series (V1-V5)
- RuleCatch.ai — AI monitoring, violation tracking, dashboards (optional)
v1.0.0 — Claude Code Mastery Starter Kit
Claude Code Mastery Project Starter Kit v1.0.0
The complete project scaffolding toolkit for Claude Code — 23 slash commands, 9 hooks, 2 skills, 2 custom agents, all pre-configured.
Highlights
- 23 Slash Commands — /help, /setup, /new-project, /review, /commit, /diagram, /refactor, /create-api, /create-e2e, /worktree, /convert-project-to-starter-kit, and more
- 9 Hooks — Deterministic enforcement: block secrets, lint on save, branch protection, port conflicts, E2E test gate, env sync, Rybbit pre-deploy gate, RuleCatch monitoring
- 2 Skills — TypeScript expert + test quality gate (triggered automatically)
- 2 Custom Agents — Security auditor + dependency analyzer (read-only)
- 15 Project Profiles — default, enterprise, api, go, vue, nuxt, svelte, sveltekit, angular, django, flask, python-api, static-site, quick, clean
- Featured Packages — ClassMCP (semantic CSS for AI), Classpresso (post-build CSS optimization), TerseJSON (lazy JSON expansion) — all MIT, all optional
- RuleCatch Free Monitor Mode —
npx @rulecatch/ai-pooler monitor --no-api-key— see every tool call, token, and cost in real time, no account needed - 8 Documentation Screenshots — Full visual gallery in README and GitHub Pages
- GitHub Pages Site — Complete documentation at docs/index.html with sidebar TOC
What's Included
| Category | Details |
|---|---|
| Commands | 23 slash commands across setup, code quality, git, API, docs, monitoring |
| Hooks | 9 enforcement hooks (secrets, branch, lint, ports, rybbit, e2e, env-sync, rulecatch) |
| Profiles | 15 project profiles for /new-project (JS/TS, Go, Python, Vue, Nuxt, Svelte, Angular, Django, Flask) |
| Database | MongoDB + SQL wrappers with connection pooling, sanitization, graceful shutdown |
| Testing | Vitest (unit) + Playwright (E2E) with minimum 3-assertion rule |
| Docker | Dockerfile optimization + local test gate before push |
| Docs | ARCHITECTURE.md, INFRASTRUCTURE.md, DECISIONS.md templates |
Getting Started
Links
- Claude Code Mastery Guide — the complete guide series (V1-V5)
- RuleCatch.ai — AI monitoring, violation tracking, dashboards (optional)
- GitHub Pages Documentation