mk-claude-code-starter
v1.0.2
Published
Pre-configured Claude Code environment for MillerKnoll engineering teams
Maintainers
Readme
MK Claude Code Starter Kit
A pre-configured Claude Code environment with production-grade agents, slash commands, rules, and hooks that encode engineering best practices.
Prerequisites
- Claude Code CLI installed and run at least once (
claudecommand available) - Python 3.10+ (for hooks)
Quick Start
npx mk-claude-code-starterThat's it. The installer copies agents, commands, rules, and hooks into ~/.claude/, backing up any existing files that differ.
Use --dry-run to preview changes without installing:
npx mk-claude-code-starter --dry-runWhat Gets Installed
| Component | Destination | Purpose |
|-----------|------------|---------|
| CLAUDE.md | ~/.claude/CLAUDE.md | Global engineering conventions |
| 3 agents | ~/.claude/agents/ | Explorer, historian, research-documentor |
| 8 commands | ~/.claude/commands/ | /init, /mk-verify, /mk-tdd, /mk-code-review, etc. |
| 9 rules | ~/.claude/rules/common/ | Coding style, testing, security, performance, etc. |
| 5 hooks | ~/.claude/hooks/ | Auto-format, secret scanning, dangerous command blocking |
Existing files are backed up to ~/.claude/backups/{timestamp}/ before being overwritten. The installer never touches settings.json, memory/, sessions/, or projects/.
Active Hooks
| Hook | Type | What It Does |
|------|------|-------------|
| auto-format.py | PostToolUse | Formats files after edits (ruff/black, prettier, gofmt, rustfmt) |
| dangerous-command-blocker.py | PreToolUse | Blocks destructive commands (rm -rf, force push to main, etc.) |
| secret-scanner.py | PreToolUse | Blocks writes containing hardcoded API keys, passwords, or tokens |
| file-size-warning.py | PostToolUse | Warns when functions exceed 50 lines or files exceed 800 lines |
| new-file-warning.py | PreToolUse | Nudge when creating a new file — check for existing files first |
Your First Steps
- Open any project directory and start Claude Code:
claude - Run
/initto scaffold the project with a CLAUDE.md and architecture docs - Run
/mk-helpto see all available commands, agents, and hooks - Try
/mk-verifyto run the full verification pipeline
Staying Updated
Just re-run — it always pulls the latest version:
npx mk-claude-code-starter@latestExisting files are backed up before updating.
License
MIT
