Skip to content

v1.3.0 — npm Package, 25 Skills, MDD Standalone, Ops Mode

Choose a tag to compare

View all tags
@TheDecipherist TheDecipherist released this 27 Jun 03:22
v1.3.0
4c13dad

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 init

After 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 install

Or 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 from block-secrets.py) — fires on the Bash tool, not Write/Edit. Catches destructive shell commands earlier
  • check-file-length.py — new hook that fires after Write/Edit; warns when a file exceeds 300 lines
  • check-branch.sh — improved cross-repo detection; no longer false-positives when Claude runs git commands against other repos
  • check-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

Assets 2
Loading