@thedecipherist/mdd 1.0.2 → 1.2.0

package/README.md

@@ -86,7 +86,7 @@ MDD flips this. You write structured documentation first. Then Claude reads **on
 MDD installs 7 Claude command files into `~/.claude/commands/`. The main router (`mdd.md`) reads your arguments and loads **only the mode file needed** - a `/mdd status` loads ~460 tokens instead of the full ~28,000.
 
 ```
-mdd.md        (~120 lines)  Router - Steps 0/0a/0b, mode dispatch, auto-branch
+mdd.md        (~120 lines)  Router - Steps 0/0a/0b, mode dispatch, Branch Guard
 mdd-build.md  (~680 lines)  BUILD MODE - Phases 0–7d
 mdd-audit.md  (~240 lines)  AUDIT MODE - Phases A1–A7
 mdd-manage.md (~340 lines)  STATUS + NOTE + SCAN + UPDATE + DEPRECATE
@@ -109,12 +109,61 @@ mdd install          # copies Claude commands to ~/.claude/commands/
 After installation, `/mdd` is available in every Claude Code session globally - no per-project setup needed.
 
 ```bash
-mdd update           # update to latest installed version
-mdd install --dir /custom/path   # install to a custom directory
+mdd update                        # update to latest installed version
+mdd install --dir /custom/path    # install to a custom directory (skips CLAUDE.md injection)
+mdd install --install-local       # install to .claude/commands/ + injects into ./CLAUDE.md
 ```
 
 **Version safety:** `mdd install` compares `mdd_version` between the installed and available versions before overwriting. If you have a newer version installed, it won't silently downgrade.
 
+### What `mdd install` sets up
+
+| What | Where | Purpose |
+|------|-------|---------|
+| 7 command `.md` files | `~/.claude/commands/` | The `/mdd` slash command and all its modes |
+| Branch Guard hook | `~/.claude/hooks/mdd-branch-guard.sh` | Blocks file writes on `main` in any MDD project |
+| Hook registration | `~/.claude/settings.json` | Wires the hook to Claude Code's PreToolUse event |
+| Guidance block | `~/.claude/CLAUDE.md` | Teaches Claude to suggest MDD automatically |
+
+---
+
+## Branch Guard — Never Work on `main`
+
+`mdd install` registers a **Claude Code `PreToolUse` hook** that fires before every file write (`Write`, `Edit`, `NotebookEdit`) in any project with a `.mdd/` directory. If the current branch is `main` or `master`, the hook blocks the operation:
+
+```
+⛔  MDD BRANCH GUARD
+
+    File modification is blocked on branch 'main'.
+    MDD never writes files directly on main or master.
+
+    Create a feature branch, then re-run your /mdd command:
+
+      git checkout -b feat/<feature-name>
+```
+
+**Why a hook and not just instructions?**
+
+Instruction-based branch checks can be lost through Claude's context compaction (when a conversation grows very long, earlier context is summarised). A `PreToolUse` hook fires at the OS level on every tool call — it cannot be compacted away, forgotten, or bypassed by stale context.
+
+**How it works end-to-end:**
+
+1. MDD instructions enforce branch hygiene in every command file (Branch Guard in `mdd.md`, Phase 0 in `mdd-build.md`, Phase PE1 in `mdd-plan.md`).
+2. The hook acts as a permanent failsafe. If Claude is about to write a file on `main`, the hook fires before the write happens, exits with code `2`, and the operation is blocked.
+3. The hook is a no-op outside `.mdd` projects and on any non-`main`/`master` branch.
+
+**MDD branch naming conventions:**
+
+| Mode | Auto-created branch |
+|------|---------------------|
+| `/mdd <feature>` | `feat/<feature-slug>` |
+| `/mdd audit` | `fix/mdd-audit-<YYYY-MM-DD>` |
+| `/mdd plan-initiative` | `feat/init-<initiative-slug>` |
+| `/mdd plan-wave` | `feat/<wave-slug>` |
+| `/mdd plan-execute` | `feat/<wave-slug>` |
+
+When on a clean `main`, MDD creates the branch automatically. When on `main` with uncommitted changes, MDD stops and offers to commit or stash first.
+
 ---
 
 ## Quick Start
@@ -138,7 +187,53 @@ npm install -g @thedecipherist/mdd && mdd install
 
 ---
 
-## All 21 Modes at a Glance
+## Claude Automatically Suggests MDD
+
+`mdd install` injects a small guidance block into your `~/.claude/CLAUDE.md` (or the project `CLAUDE.md` for `--install-local`). From that point on, whenever Claude detects a `.mdd/` directory in the current project it automatically evaluates every implementation or infrastructure request and suggests the right MDD workflow — even if you didn't type `/mdd`.
+
+**What Claude checks, in order:**
+
+**1. Does it already exist?**
+Claude scans `.mdd/.startup.md` — which lists every documented feature and ops runbook with their tags. If your prompt overlaps with something already documented, Claude flags it before you duplicate work:
+
+> *"This looks related to `02-user-auth` in your MDD docs. Want to use `/mdd update 02` to modify it, or `/mdd audit 02` to review it first?"*
+
+**2. Is it ops/infrastructure?**
+Deploy procedures, CI/CD pipelines, commit hooks, Docker builds, cron jobs, DNS changes — anything operational gets flagged for a runbook instead of ad-hoc implementation:
+
+> *"This sounds like an ops procedure. Want to document it as a repeatable runbook with `/mdd ops deploy to production`?"*
+
+**3. Is it initiative-scale?**
+Large requests touching three or more independent concerns get routed to initiative/wave planning instead of a single feature doc:
+
+> *"This looks initiative-scale. Want to plan it with `/mdd plan-initiative`?"*
+
+**4. Is it a single new feature?**
+Everything else gets the standard build mode prompt:
+
+> *"Want me to use `/mdd add payment processing` to build this with documentation and tests first?"*
+
+Claude always **asks** — it never auto-invokes `/mdd`. If you say no, it proceeds with direct implementation as normal. The detection is also intentionally narrow: bug fixes, typo corrections, config tweaks, and one-off shell commands are never flagged.
+
+**How it detects overlap without loading full docs:**
+
+Every feature doc and ops runbook has a `tags:` field (4–8 domain-concept keywords). These tags are surfaced in `.mdd/.startup.md` — a compact session-context file that's already injected into every Claude conversation. Claude scans the tag list in milliseconds, with no full-document loading and no context bloat.
+
+```
+## Features Documented
+- 01-project-scaffolding (complete) [typescript, express, project-setup, scaffolding]
+- 02-user-auth (in_progress) [auth, jwt, login, sessions, middleware]
+- 03-payment-flow (draft) [stripe, payments, checkout, webhooks]
+
+## Ops Runbooks
+- prod-deploy [deploy, dokploy, docker, eu-west, canary, health-check]
+```
+
+**The injection is idempotent.** Running `mdd install` or `mdd update` again never duplicates the block.
+
+---
+
+## All 22 Modes at a Glance
 
 ```
 /mdd <feature description>                 Build Mode - Document, plan, and implement
@@ -146,6 +241,7 @@ npm install -g @thedecipherist/mdd && mdd install
 /mdd status                                Overview: docs, tests, audit state, initiatives
 /mdd scan                                  Detect features whose source files changed
 /mdd update <feature-id>                   Re-sync a feature doc after code changes
+/mdd rebuild-tags [--force]                Generate tags for all docs and rebuild .startup.md
 /mdd note "text"                           Append a timestamped note to .mdd/.startup.md
 /mdd note list                             Print the Notes section
 /mdd note clear                            Wipe all notes (asks for confirmation)
@@ -235,6 +331,7 @@ last_synced: 2026-05-07
 status: draft
 phase: documentation
 mdd_version: 8
+tags: [auth, jwt, login, sessions, middleware]
 known_issues: []
 ---
 
@@ -692,6 +789,7 @@ Every `.mdd/docs/<NN>-<feature-name>.md` file uses this YAML frontmatter:
 | `status` | `draft` → `in_progress` → `complete` → `deprecated` |
 | `phase` | Last completed phase name |
 | `mdd_version` | Version of MDD that created/last updated this doc |
+| `tags` | 4–8 domain-concept keywords surfaced in `.startup.md` so Claude can detect when a prompt relates to this feature (e.g. `[auth, jwt, login, sessions]`) |
 | `known_issues` | Issues discovered during audits or implementation |
 
 **`depends_on` rules:**
@@ -743,9 +841,12 @@ Generated: 2026-05-07 | Branch: feat/user-auth
 Framework: Express + React | DB: PostgreSQL | Host: Dokploy
 
 ## Features Documented
-01-project-scaffolding (complete)
-02-user-auth (in_progress)
-...
+- 01-project-scaffolding (complete) [typescript, express, project-setup, scaffolding]
+- 02-user-auth (in_progress) [auth, jwt, login, sessions, middleware]
+- 03-payment-flow (draft) [stripe, payments, checkout, webhooks]
+
+## Ops Runbooks
+- prod-deploy [deploy, dokploy, docker, eu-west, canary, health-check]
 
 ## Last Audit
 2026-05-01 - 20 findings, 17 fixed, 3 open

package/commands/mdd-audit.md

@@ -214,7 +214,7 @@ Estimated fix time: <N> hours (traditional) → <N> minutes (MDD)
 Fix all now? (yes / review report first / fix only P1+P2)
 ```
 
-**After the report is written**, trigger the `.mdd/.startup.md` rebuild (same logic as in Status Mode — rebuild auto-generated zone, preserve Notes zone) so the Last Audit block reflects the new findings regardless of whether the user proceeds with fixes.
+**After the report is written**, run a tag pass before the startup rebuild: for any `.mdd/docs/*.md` or `.mdd/ops/*.md` file missing a `tags:` field, generate and write tags now (same logic as Phase RT2 in REBUILD-TAGS MODE). Docs that already have `tags:` are untouched. Then trigger the `.mdd/.startup.md` rebuild (same logic as in Status Mode — rebuild auto-generated zone, preserve Notes zone) so the Last Audit block and tag-enriched feature list are both current.
 
 If user says yes (or selects a subset):
 
@@ -226,7 +226,7 @@ If user says yes (or selects a subset):
 
 Report progress per finding. Update documentation `known_issues` to remove fixed items. Update `mdd_version` to current on every `.mdd/docs/*.md` file that is edited during fixes.
 
-**After fixes are complete and results are written to `.mdd/audits/results-<date>.md`**, trigger the `.mdd/.startup.md` rebuild so the Last Audit block reflects the new numbers.
+**After fixes are complete and results are written to `.mdd/audits/results-<date>.md`**, run the same tag pass (generate missing tags for any doc still lacking them), then trigger the `.mdd/.startup.md` rebuild so the Last Audit block and tag list both reflect the final state.
 
 ---
 

package/commands/mdd-branch-guard.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# MDD Branch Guard
+# PreToolUse hook — blocks Write/Edit/NotebookEdit on main/master in MDD projects.
+# Installed by: mdd install (into .claude/hooks/ or ~/.claude/hooks/)
+
+# Only active in MDD projects
+[ -d ".mdd" ] || exit 0
+
+# Check current branch
+BRANCH=$(git branch --show-current 2>/dev/null)
+[ -z "$BRANCH" ] && exit 0
+
+# Only block on main/master
+[[ "$BRANCH" == "main" || "$BRANCH" == "master" ]] || exit 0
+
+# Count uncommitted changes for context
+CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+
+echo ""
+echo "⛔  MDD BRANCH GUARD"
+echo ""
+echo "    File modification is blocked on branch '${BRANCH}'."
+echo "    MDD never writes files directly on main or master."
+echo ""
+if [ "$CHANGES" -gt 0 ]; then
+  echo "    You have ${CHANGES} uncommitted change(s). Commit or stash first:"
+  echo ""
+  echo "      git add -A && git commit -m 'wip: ...' && git checkout -b feat/<name>"
+  echo "      — or —"
+  echo "      git stash && git checkout -b feat/<name>"
+else
+  echo "    Create a feature branch, then re-run your /mdd command:"
+  echo ""
+  echo "      git checkout -b feat/<feature-name>"
+fi
+echo ""
+
+exit 2

package/commands/mdd-build.md

@@ -191,6 +191,7 @@ last_synced: <YYYY-MM-DD>
 status: draft
 phase: <last completed phase name, or "all" when fully built>
 mdd_version: <read from mdd.md frontmatter mdd_version field>
+tags: [<4-8 domain-concept keywords — systems touched, technology, feature names. NOT file paths>]
 known_issues: []
 ---
 

package/commands/mdd-lifecycle.md

@@ -61,6 +61,7 @@ Draft a complete feature doc following the Phase 3 template. Set:
 - `last_synced: <today>`
 - `status: draft` (since business intent may be incomplete)
 - `phase: reverse-engineered`
+- `tags: [...]` — infer 4–8 domain-concept keywords from the inferred purpose, routes, models, and source file names. NOT raw file paths — use the concept (e.g. `auth`, `api`, `stripe` not `src/handlers/stripe.ts`)
 
 **In regenerate mode:** Show the existing doc alongside the new draft:
 ```
@@ -195,11 +196,11 @@ Batch-patches missing frontmatter fields (`last_synced`, `status`, `phase`) acro
 ```
 📋 Upgrade Inventory
 
-Doc                              | last_synced | status | phase
-─────────────────────────────────|─────────────|────────|──────────────
-01-project-scaffolding           | ❌ missing  | ❌     | ❌
-02-profile-system                | ❌ missing  | ✅     | ❌
-03-database-layer                | ✅ present  | ✅     | ✅
+Doc                              | last_synced | status | phase | tags
+─────────────────────────────────|─────────────|────────|───────|──────
+01-project-scaffolding           | ❌ missing  | ❌     | ❌    | ❌
+02-profile-system                | ❌ missing  | ✅     | ❌    | ✅
+03-database-layer                | ✅ present  | ✅     | ✅    | ❌
 ...
 
 Docs needing upgrade: <N> of <total>
@@ -207,6 +208,7 @@ Fields to add:
   last_synced — <N> docs
   status      — <N> docs
   phase       — <N> docs
+  tags        — <N> docs (run /mdd rebuild-tags after upgrade to populate)
 ```
 
 4. If 0 docs need upgrade → report "All docs are up to date. Nothing to patch." and stop.
@@ -307,11 +309,13 @@ data_flow: ...
 last_synced: <new>    ← insert here if missing
 status: <new>         ← insert here if missing
 phase: <new>          ← insert here if missing
+mdd_version: <new>    ← insert here if missing
+tags: <new>           ← insert here if missing (do not generate tags in upgrade — run /mdd rebuild-tags after)
 known_issues: []
 ---
 ```
 
-Insert new fields **before** `known_issues` to keep the canonical order.
+Insert new fields **before** `known_issues` to keep the canonical order. **Do not attempt to generate tag values during upgrade** — tags require reading doc content to produce meaningful keywords. After running upgrade, run `/mdd rebuild-tags` to populate tags on any docs that need them.
 
 Report progress as you go:
 ```

package/commands/mdd-manage.md

@@ -7,7 +7,7 @@ Quick overview of MDD state for the project:
 3. **Scan `.mdd/jobs/`** — detect any active audit job (see below)
 4. **Count tests** — `pnpm test:unit --reporter=json 2>/dev/null | jq '.numTotalTests'`
 5. **Count known issues** — grep `known_issues` across all docs
-6. **Read current mdd_version** — from `mdd.md` frontmatter (or `~/.claude/commands/mdd.md` if not local)
+6. **Read current mdd_version** — from `mdd.md` frontmatter. Check `.claude/commands/mdd.md` first (local install), then `~/.claude/commands/mdd.md` (global install). Use whichever exists.
 7. **Scan all `.mdd/` files** — grep `mdd_version` from each, group by version number
 8. **Scan `.mdd/initiatives/`** — count initiative files, group by status
 9. **Scan `.mdd/waves/`** — count wave files, group by status; for each active wave count complete vs total features
@@ -63,8 +63,8 @@ After collecting status, rebuild the auto-generated zone of `.mdd/.startup.md`:
    - `Generated: <YYYY-MM-DD>` (date only, no time)
    - `Branch:` from `git branch --show-current`
    - `Stack:` from `CLAUDE.md` or `claude-mastery-project.conf` if detectable, otherwise `(unknown)`
-   - `Features Documented:` sorted list of `.mdd/docs/*.md` filenames with status if detectable from frontmatter
-   - `Ops Runbooks:` sorted list of `.mdd/ops/*.md` filenames with status — omit section entirely if `.mdd/ops/` is empty
+   - `Features Documented:` sorted list of `.mdd/docs/*.md` filenames with status and tags — format: `- <id> (<status>) [tag1, tag2, ...]`. If `tags:` is missing from a doc, omit the bracket section for that entry.
+   - `Ops Runbooks:` sorted list of `.mdd/ops/*.md` filenames with tags — format: `- <slug> [tag1, tag2, ...]`. Omit section entirely if `.mdd/ops/` is empty.
    - `Last Audit:` from the most recent `.mdd/audits/report-*.md` — extract findings/fixed/open counts
    - `Rules Summary:` static block (does not change)
 3. Write the rebuilt auto-generated section + `---` divider + preserved Notes section back to `.mdd/.startup.md`. Update `mdd_version` in the file's frontmatter to current.
@@ -338,3 +338,69 @@ Test files: <kept/deleted per user choice>
 ```
 
 ---
+
+## REBUILD-TAGS MODE — `/mdd rebuild-tags [--force]`
+
+Triggered when arguments start with `rebuild-tags`. Scans all feature docs and ops runbooks, generates `tags:` for any doc missing the field, then rebuilds `.startup.md`.
+
+**Use case:** Migrating existing projects to the tag system. Safe to run multiple times — docs that already have `tags:` are skipped unless `--force` is passed.
+
+### Phase RT1 — Inventory
+
+1. Glob `.mdd/docs/*.md` (excluding `archive/`) and `.mdd/ops/*.md` (excluding `archive/`).
+2. For each doc, check frontmatter for a `tags:` field.
+3. Build an inventory table:
+
+```
+🏷️  Rebuild Tags — Inventory
+
+Doc                              | Has tags?
+─────────────────────────────────|──────────
+01-docs-site                     | ❌ missing
+02-dashboards-showcase           | ❌ missing
+03-install-local-flag            | ✅ present
+swarmk-dokploy (ops)             | ❌ missing
+
+Docs needing tags: <N> of <total>
+```
+
+If 0 docs need tags (and `--force` not passed) → report "All docs already have tags. `.startup.md` will be rebuilt." and jump to Phase RT3.
+
+### Phase RT2 — Generate Tags
+
+For each doc missing `tags:` (or all docs if `--force`):
+
+1. Read the doc's frontmatter and `## Purpose` section (first paragraph only).
+2. Generate 4–8 domain-concept keywords that identify what the doc is about:
+   - Use: title words, purpose concepts, platform/technology names, key system names, operation types
+   - Do NOT use: raw file paths, generic words like "feature" or "system", version numbers
+   - For ops docs: emphasise platform, services, environments, operation type (e.g. `deploy`, `dokploy`, `docker`, `canary`)
+   - For feature docs: emphasise domain concepts, technology, feature names (e.g. `auth`, `cli`, `install`, `flags`)
+3. Write `tags:` to the doc frontmatter, inserting it **before** `known_issues:`.
+4. Report one line per doc: `✅ 01-docs-site — tags: [github-pages, documentation, landing-page, user-guide]`
+
+**`--force` behaviour:** Regenerate and overwrite `tags:` even on docs that already have them. Show old → new for each.
+
+### Phase RT3 — Rebuild Startup
+
+Trigger the `.mdd/.startup.md` rebuild (same logic as Status Mode — rebuild auto-generated zone, preserve Notes zone). The rebuilt startup now reflects tags on every feature and ops line.
+
+### Phase RT4 — Report
+
+```
+✅ Rebuild Tags Complete
+
+Feature docs processed: <N>
+Ops runbooks processed: <N>
+Tags generated:         <N> docs
+Tags skipped (present): <N> docs
+
+.startup.md rebuilt with tag format:
+  - 01-docs-site (complete) [github-pages, documentation, landing-page, user-guide]
+  - 03-install-local-flag (complete) [cli, install, local-install, flags]
+  ...
+
+Run /mdd status to see the full updated startup snapshot.
+```
+
+---

package/commands/mdd-ops.md

@@ -85,6 +85,7 @@ services:
 status: draft
 last_synced: <YYYY-MM-DD>
 mdd_version: <current>
+tags: [<4-8 keywords — platform, services, environments, operation type. e.g. deploy, dokploy, docker, eu-west, canary>]
 known_issues: []
 ---
 

package/commands/mdd-plan.md

@@ -2,6 +2,20 @@
 
 Triggered when arguments start with `plan-initiative`. Creates a new initiative doc.
 
+### Phase PI0 — Branch Guard
+
+Run before any file creation:
+
+```bash
+BRANCH=$(git branch --show-current)
+DIRTY=$(git status --porcelain)
+```
+
+- **On `main` or `master` with uncommitted changes** → STOP. Show the Scenario A prompt from mdd.md Branch Guard.
+- **On `main` or `master`, clean** → auto-branch to `feat/init-<initiative-slug>`. If the slug is not yet known (title not asked), use `feat/mdd-initiative` as a temporary name and rename the branch after the title is collected.
+- **On a feature branch** → working dirty is fine. Proceed — initiative planning docs belong on whatever branch is current.
+- **Never proceed on main.** Hard block.
+
 ### Phase PI1 — Mode choice
 
 Ask the user:
@@ -86,6 +100,18 @@ Triggered when arguments start with `plan-wave`. Takes a wave slug (e.g. `auth-s
 
 ### Phase PW1 — Load and validate
 
+**Step 0 — Branch guard:**
+
+```bash
+BRANCH=$(git branch --show-current)
+DIRTY=$(git status --porcelain)
+```
+
+- **On `main` or `master` with uncommitted changes** → STOP. Show Scenario A from mdd.md Branch Guard.
+- **On `main` or `master`, clean** → auto-branch to `feat/<wave-slug>`.
+- **On a feature branch** → proceed (planning docs belong on this branch).
+- **Never proceed on main.** Hard block.
+
 1. Parse `<wave-slug>` from arguments — hard stop *"Wave slug required. Usage: /mdd plan-wave <wave-slug>"* if missing.
 2. Derive initiative slug: everything before `-wave-N` (e.g. `auth-system-wave-2` → `auth-system`).
 3. Read `initiatives/<initiative-slug>.md` fresh from disk — hard stop *"Initiative does not exist: `initiatives/<slug>.md`"* if not found.
@@ -160,6 +186,30 @@ Triggered when arguments start with `plan-execute`. Runs the full MDD build flow
 
 ### Phase PE1 — Load and validate
 
+**Step 0 — Branch guard (runs before everything else):**
+
+```bash
+BRANCH=$(git branch --show-current)
+DIRTY=$(git status --porcelain)
+```
+
+- **On `main` or `master` with uncommitted changes** → STOP. Show the Scenario A prompt from the Branch Guard in mdd.md. Do not proceed until resolved.
+- **On `main` or `master`, clean** → auto-branch to `feat/<wave-slug>` immediately. Report: `✅ Branched to feat/<wave-slug>`.
+- **On a feature branch that doesn't match `<wave-slug>`** → mismatch. Show:
+  ```
+  ⚠️  Branch mismatch for wave execution.
+
+  Current branch: <branch-name>
+  Expected:       feat/<wave-slug>
+
+  MDD expects one wave per branch. What would you like to do?
+    (a) Commit, merge to main, and branch fresh to feat/<wave-slug>
+    (b) Continue on this branch (not recommended — mixes work)
+    (c) Abort
+  ```
+  Follow the same (a)/(b)/(c) logic as mdd-build.md Phase 0.
+- **Never proceed on main.** This is a hard block regardless of clean/dirty state.
+
 1. Parse `<wave-slug>` — hard stop *"Wave does not exist"* if `waves/<wave-slug>.md` not found.
 2. Read the wave doc.
 3. Derive and read the parent initiative — hard stop if not found.

package/commands/mdd.md

@@ -53,6 +53,11 @@ Framework: (unknown) | DB: (unknown) | Host: (unknown)
 
 ## Features Documented
 (none yet — run /mdd <feature> to create your first doc)
+Format once populated: - <id> (<status>) [tag1, tag2, ...]
+
+## Ops Runbooks
+(none yet — run /mdd ops <description> to create one)
+Format once populated: - <slug> [tag1, tag2, ...]
 
 ## Last Audit
 (no audit run yet — run /mdd audit to generate findings)
@@ -99,44 +104,100 @@ The user's full arguments are: **$ARGUMENTS**
 
 Parse these arguments to determine the mode. **Before doing anything else, read the appropriate mode file listed below.** The mode file contains the complete instructions for that mode. When mode file instructions reference `$ARGUMENTS`, treat it as the arguments stated above.
 
-Find the MDD commands directory by checking `~/.claude/commands/` (global install via `npm install -g mdd`).
+Find the MDD commands directory by checking in this order:
+1. `.claude/commands/` in the current project (local install via `mdd install --install-local`)
+2. `~/.claude/commands/` (global install via `npm install -g @thedecipherist/mdd && mdd install`)
+
+Use whichever path contains `mdd-audit.md`. Store it as `$MDD_DIR` and use it for all mode file reads below.
 
 - If arguments start with `audit` →
-  **Read `~/.claude/commands/mdd-audit.md` then follow its AUDIT MODE instructions.**
+  **Read `$MDD_DIR/mdd-audit.md` then follow its AUDIT MODE instructions.**
 
-- If arguments start with `status`, `note`, `scan`, `update`, or `deprecate` →
-  **Read `~/.claude/commands/mdd-manage.md` then follow the relevant mode instructions.**
+- If arguments start with `status`, `note`, `scan`, `update`, `deprecate`, or `rebuild-tags` →
+  **Read `$MDD_DIR/mdd-manage.md` then follow the relevant mode instructions.**
 
 - If arguments start with `reverse-engineer`, `reverse`, `graph`, or `upgrade` →
-  **Read `~/.claude/commands/mdd-lifecycle.md` then follow the relevant mode instructions.**
+  **Read `$MDD_DIR/mdd-lifecycle.md` then follow the relevant mode instructions.**
 
 - If arguments start with `plan-` →
-  **Read `~/.claude/commands/mdd-plan.md` then follow the relevant PLAN mode instructions.**
+  **Read `$MDD_DIR/mdd-plan.md` then follow the relevant PLAN mode instructions.**
 
 - If arguments start with `ops`, `runop`, `update-op`, or `commands` →
-  **Read `~/.claude/commands/mdd-ops.md` then follow the relevant OPS/COMMANDS mode instructions.**
+  **Read `$MDD_DIR/mdd-ops.md` then follow the relevant OPS/COMMANDS mode instructions.**
 
 - If arguments are empty → ask the user what they want to do (build a feature, run an audit, check status, etc.)
 
-- Otherwise → **Read `~/.claude/commands/mdd-build.md` then follow BUILD MODE instructions.**
+- Otherwise → **Read `$MDD_DIR/mdd-build.md` then follow BUILD MODE instructions.**
 
 ---
 
-## Auto-Branch (All Modes)
+## Branch Guard (All Modes)
 
-**If the user already chose a worktree in Step 0, skip auto-branch entirely** — the worktree was created with its own dedicated branch.
+**This guard is mandatory. MDD never creates or modifies files directly on `main` or `master`. No exceptions — not even for documentation, planning, or ops files.**
 
-Otherwise, before creating or modifying any files, check the current branch:
+**If the user already chose a worktree in Step 0, skip entirely** — the worktree has its own dedicated branch.
+
+Otherwise, before creating or modifying any files, run:
 
 ```bash
-git branch --show-current
+BRANCH=$(git branch --show-current)
+DIRTY=$(git status --porcelain)
+```
+
+---
+
+### Scenario A — On `main` or `master`, working tree has uncommitted changes
+
+**STOP. Do not create or modify any file.**
+
 ```
+🚫 MDD Branch Guard — cannot proceed on main with uncommitted changes.
+
+Branch:   main
+Dirty:    <N> file(s) modified / untracked
+
+MDD never works directly on main, and uncommitted changes must be
+resolved before branching safely.
+
+Choose:
+  (a) Commit now  — stage all changes and commit, then MDD auto-branches
+  (b) Stash now   — git stash, then MDD auto-branches
+  (c) Abort       — handle git manually, then re-run /mdd
+```
+
+- **(a) Commit:** `git add -A`, generate a short conventional commit message from the changed files, commit, then proceed to Scenario B.
+- **(b) Stash:** `git stash`, then proceed to Scenario B.
+- **(c) Abort:** stop entirely — do not create any files.
+
+---
+
+### Scenario B — On `main` or `master`, clean working tree
+
+Auto-branch immediately — no user prompt. Derive the branch name from the active mode:
+
+| Mode | Branch name |
+|------|-------------|
+| Build (`/mdd <feature>`) | `feat/<feature-slug>` |
+| Audit (`/mdd audit`) | `fix/mdd-audit-<YYYY-MM-DD>` |
+| plan-initiative | `feat/init-<initiative-slug>` |
+| plan-wave | `feat/<wave-slug>` |
+| plan-execute | `feat/<wave-slug>` |
+| Any other mode | `feat/<slug-from-arguments>` |
+
+Run `git checkout -b <branch-name>` and report:
+```
+✅ Branched to <branch-name> — proceeding with MDD.
+```
+
+---
+
+### Scenario C — Already on a feature or fix branch
+
+Working tree dirty (in-progress changes) is **expected and fine** — that work belongs on this branch.
+
+Each mode's Phase 0 handles mismatch detection (does the new task belong on this branch?). See mdd-build.md Phase 0 and mdd-plan.md for details.
 
-**Default behavior** (`auto_branch = true` in `claude-mastery-project.conf`):
-- If on `main` or `master`:
-  - Build mode: `git checkout -b feat/<feature-name>`
-  - Audit mode: `git checkout -b fix/mdd-audit-<date>`
-- If already on a feature branch: proceed
+**One hard rule:** A branch starting with `fix/mdd-audit-` is an audit branch. Build and plan modes must not reuse it — fall through to Scenario B naming instead.
 
 ---
 

package/dist/cli.js

@@ -5,6 +5,7 @@ import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { join, dirname } from 'path';
 import { cwd } from 'process';
+import { homedir } from 'os';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
@@ -23,7 +24,13 @@ program
     const dirExplicit = this.getOptionValueSource('dir') === 'cli';
     const local = options.installLocal && !dirExplicit;
     const effectiveDir = local ? join(cwd(), '.claude/commands') : options.dir;
-    install({ dir: effectiveDir, force: options.force, local });
+    const claudeMdPath = dirExplicit ? undefined
+        : local ? join(cwd(), 'CLAUDE.md')
+            : join(homedir(), '.claude', 'CLAUDE.md');
+    const settingsPath = dirExplicit ? undefined
+        : local ? join(cwd(), '.claude', 'settings.json')
+            : join(homedir(), '.claude', 'settings.json');
+    install({ dir: effectiveDir, force: options.force, local, claudeMdPath, settingsPath });
 });
 program
     .command('update')
@@ -34,7 +41,13 @@ program
     const dirExplicit = this.getOptionValueSource('dir') === 'cli';
     const local = options.installLocal && !dirExplicit;
     const effectiveDir = local ? join(cwd(), '.claude/commands') : options.dir;
-    install({ dir: effectiveDir, force: true, local });
+    const claudeMdPath = dirExplicit ? undefined
+        : local ? join(cwd(), 'CLAUDE.md')
+            : join(homedir(), '.claude', 'CLAUDE.md');
+    const settingsPath = dirExplicit ? undefined
+        : local ? join(cwd(), '.claude', 'settings.json')
+            : join(homedir(), '.claude', 'settings.json');
+    install({ dir: effectiveDir, force: true, local, claudeMdPath, settingsPath });
 });
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAE9B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAwB,CAAC;AAEzG,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,0DAA0D,CAAC;KACvE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,cAAc,EAAE,wDAAwD,EAAE,oBAAoB,CAAC;KACtG,MAAM,CAAC,iBAAiB,EAAE,+DAA+D,EAAE,KAAK,CAAC;KACjG,MAAM,CAAC,SAAS,EAAE,qDAAqD,EAAE,KAAK,CAAC;KAC/E,MAAM,CAAC,UAAyB,OAAgE;IAC/F,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,WAAW,CAAC;IACnD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAC3E,OAAO,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,mEAAmE,CAAC;KAChF,MAAM,CAAC,cAAc,EAAE,0BAA0B,EAAE,oBAAoB,CAAC;KACxE,MAAM,CAAC,iBAAiB,EAAE,oDAAoD,EAAE,KAAK,CAAC;KACtF,MAAM,CAAC,UAAyB,OAA+C;IAC9E,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,WAAW,CAAC;IACnD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAC3E,OAAO,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/install.d.ts

@@ -2,6 +2,8 @@ interface InstallOptions {
     dir: string;
     force?: boolean;
     local?: boolean;
+    claudeMdPath?: string;
+    settingsPath?: string;
 }
 export declare function install(options: InstallOptions): void;
 export {};

package/dist/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AASA,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAUD,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CA4ErD"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAQA,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAUD,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAkGrD"}

package/dist/install.js

@@ -1,8 +1,7 @@
-import { copyFileSync, mkdirSync, existsSync, readdirSync, readFileSync } from 'fs';
-import { join, resolve } from 'path';
+import { copyFileSync, mkdirSync, existsSync, readdirSync, readFileSync, writeFileSync, appendFileSync, chmodSync } from 'fs';
+import { join, resolve, dirname } from 'path';
 import { homedir } from 'os';
 import { fileURLToPath } from 'url';
-import { dirname } from 'path';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 export function install(options) {
@@ -76,6 +75,26 @@ export function install(options) {
     if (options.local) {
         console.log('  Tip: add .claude/commands/ to your .gitignore to keep these files out of git.\n');
     }
+    if (options.claudeMdPath) {
+        const claudeResult = injectClaudeGuidance(resolve(options.claudeMdPath.replace('~', homedir())));
+        const icon = claudeResult.status === 'error' ? '✗' : claudeResult.status === 'skipped' ? '·' : '✓';
+        console.log(`  ${icon} CLAUDE.md — ${claudeResult.message}`);
+        console.log('');
+    }
+    if (options.settingsPath) {
+        const hookScriptSrc = join(srcDir, 'mdd-branch-guard.sh');
+        const hooksDir = join(resolve(options.settingsPath.replace('~', homedir()), '..'), 'hooks');
+        const hookScriptDest = join(hooksDir, 'mdd-branch-guard.sh');
+        const hookResult = installHook({
+            hookScriptSrc,
+            hookScriptDest,
+            settingsPath: resolve(options.settingsPath.replace('~', homedir())),
+            local: options.local ?? false,
+        });
+        const icon = hookResult.status === 'error' ? '✗' : hookResult.status === 'skipped' ? '·' : '✓';
+        console.log(`  ${icon} Branch Guard hook — ${hookResult.message}`);
+        console.log('');
+    }
     console.log('Open Claude Code and run /mdd to get started.\n');
 }
 function getMddVersion(content) {
@@ -91,4 +110,104 @@ function getPackageVersion() {
         return 'unknown';
     }
 }
+const CLAUDE_GUIDANCE_MARKER = '## MDD — Manual-First Development';
+const CLAUDE_GUIDANCE_BLOCK = `
+## MDD — Manual-First Development
+
+If a \`.mdd/\` directory exists in the current project, apply this logic whenever
+the user asks you to implement, build, modify, deploy, or automate something —
+and they have NOT used \`/mdd\` to initiate the request:
+
+**Step 1 — Does it already exist?**
+Scan \`.mdd/.startup.md\` (Features AND Ops Runbooks sections). Do any tags or
+names match what the user is asking about?
+→ Feature match: "This looks related to \`<NN>-<feature-name>\`. Want to use
+  \`/mdd update <NN>\` to modify it, or \`/mdd audit <NN>\` to review it first?"
+→ Ops match: "You already have a \`<slug>\` runbook for this. Want to run it
+  with \`/mdd runop <slug>\` or update it with \`/mdd update-op <slug>\`?"
+
+**Step 2 — What kind of request is it?**
+
+Infrastructure or ops? (deploy, CI/CD, Docker, commit hooks, pipelines,
+cron jobs, webhooks, DNS, SSL, rollback, health checks, server config)
+→ "This sounds like an ops procedure. Want to document it as a repeatable
+  runbook with \`/mdd ops <description>\`?"
+
+Feature work touching 3+ independent concerns?
+→ "This looks initiative-scale. Want to plan it with \`/mdd plan-initiative\`?"
+
+Single feature or bounded change?
+→ "Want me to use \`/mdd <description>\` to build this with docs and tests first?"
+
+Always ask — never auto-invoke. If the user says no, proceed as normal.
+
+Skip entirely for: bug fixes, typos, config tweaks, single-line changes,
+one-off shell commands.
+`;
+function installHook(opts) {
+    try {
+        // Install the hook script
+        mkdirSync(dirname(opts.hookScriptDest), { recursive: true });
+        copyFileSync(opts.hookScriptSrc, opts.hookScriptDest);
+        chmodSync(opts.hookScriptDest, 0o755);
+        // Derive hook command — local uses relative path, global uses $HOME
+        const hookCommand = opts.local
+            ? 'bash .claude/hooks/mdd-branch-guard.sh'
+            : 'bash $HOME/.claude/hooks/mdd-branch-guard.sh';
+        const HOOK_MARKER = 'mdd-branch-guard';
+        // Read existing settings.json or start fresh
+        let settings = {};
+        if (existsSync(opts.settingsPath)) {
+            try {
+                settings = JSON.parse(readFileSync(opts.settingsPath, 'utf-8'));
+            }
+            catch {
+                // Unparseable settings — leave existing file alone to avoid corruption
+                return { status: 'error', message: `could not parse ${opts.settingsPath}` };
+            }
+        }
+        // Check if hook already registered
+        const hooksSection = settings['hooks'];
+        const preToolUse = (hooksSection?.['PreToolUse'] ?? []);
+        const alreadyInstalled = preToolUse.some(group => {
+            const hooks = group['hooks'];
+            return hooks?.some(h => String(h['command'] ?? '').includes(HOOK_MARKER));
+        });
+        if (alreadyInstalled) {
+            return { status: 'skipped', message: 'already registered in settings.json' };
+        }
+        // Merge hook entry into PreToolUse
+        const newEntry = {
+            matcher: 'Write|Edit|NotebookEdit',
+            hooks: [{ type: 'command', command: hookCommand }],
+        };
+        settings['hooks'] = {
+            ...(hooksSection ?? {}),
+            PreToolUse: [...preToolUse, newEntry],
+        };
+        writeFileSync(opts.settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+        return { status: 'installed', message: `hook registered in ${opts.settingsPath}` };
+    }
+    catch (err) {
+        return { status: 'error', message: String(err) };
+    }
+}
+function injectClaudeGuidance(claudeMdPath) {
+    try {
+        if (existsSync(claudeMdPath)) {
+            const existing = readFileSync(claudeMdPath, 'utf-8');
+            if (existing.includes(CLAUDE_GUIDANCE_MARKER)) {
+                return { status: 'skipped', message: 'guidance already present' };
+            }
+            appendFileSync(claudeMdPath, CLAUDE_GUIDANCE_BLOCK, 'utf-8');
+        }
+        else {
+            writeFileSync(claudeMdPath, CLAUDE_GUIDANCE_BLOCK.trimStart(), 'utf-8');
+        }
+        return { status: 'injected', message: 'guidance injected' };
+    }
+    catch (err) {
+        return { status: 'error', message: String(err) };
+    }
+}
 //# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAgBtC,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,kCAAkC;QAClC,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAEjC,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACvC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACtB,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;oBACzD,MAAM,OAAO,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC3D,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;wBACtB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,OAAO,qBAAqB,EAAE,CAAC,CAAC;wBACpF,SAAS;oBACX,CAAC;oBACD,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBACxB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;gBACrF,CAAC;qBAAM,CAAC;oBACN,iEAAiE;oBACjE,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBACxB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,mCAAmC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,IAAI,CAAC,CAAC;IAE/C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7E,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS;YAClE,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,SAAS,GAAG;YAC1C,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACjG,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAEhE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,oCAAoC,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,6BAA6B,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;IACnG,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAwB,CAAC;QACzG,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thedecipherist/mdd",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "MDD — Manual-Driven Development workflow for Claude Code",
   "type": "module",
   "bin": {