gen-claudemd

---
name: gen-claudemd
description: >
  Regenerate the nyann-managed block in CLAUDE.md from the current profile,
  stack detection, and doc plan — without re-running a full bootstrap or
  retrofit. TRIGGER when the user says "regenerate CLAUDE.md",
  "update CLAUDE.md", "refresh CLAUDE.md", "rebuild CLAUDE.md",
  "re-gen CLAUDE.md", "my CLAUDE.md is stale", "CLAUDE.md doesn't match
  my profile", "sync CLAUDE.md with the profile", "/nyann:gen-claudemd".
  Do NOT trigger on "optimize CLAUDE.md" / "trim CLAUDE.md" / "what's
  unused" — that's the `optimize-claudemd` skill (usage-analytics-driven).
  Do NOT trigger on "explain CLAUDE.md" / "what's in CLAUDE.md" — that's
  `explain-state`. Do NOT trigger on initial project setup — that's
  `bootstrap-project`.
---

# gen-claudemd

Standalone CLAUDE.md regeneration. Wraps `bin/gen-claudemd.sh` with the
same inputs bootstrap uses, but skips the full bootstrap pipeline so the
user can refresh CLAUDE.md after changing their profile, adding docs, or
restructuring workspaces.

## 1. Gather inputs

The generator needs three inputs. Resolve them in this order:

1. **Profile** — resolve the active profile via preferences or CLAUDE.md
   markers; load with `bin/load-profile.sh <name>`. If the user names a
   specific profile, use that instead.
2. **Doc plan** — the generator needs a DocumentationPlan. To preserve
   the repo's existing doc routing (local / Obsidian / Notion / split),
   re-derive the plan using the same routing the user originally chose.
   Check `profile.documentation.storage_strategy`; if it names a
   non-local backend, also run `bin/detect-mcp-docs.sh` and pass
   `--mcp-targets` to route-docs. For local-only repos (the common
   case): `bin/route-docs.sh --profile <profile-path>` suffices.
   Write the resulting DocumentationPlan JSON to a temp file.
3. **Stack** (optional but recommended) — run `bin/detect-stack.sh --path .`
   for a StackDescriptor JSON. Write it to a temp file. Skip if
   detection fails (gen-claudemd falls back to profile-only data).

For monorepos, also resolve workspace configs:
```
bin/resolve-workspace-configs.sh --stack <stack-path> --profile <profile-path>
```
Pass the result via `--workspace-configs <path>`.

## 2. Snapshot the current state

Before running the generator, capture the existing managed block so
you can show a before/after diff. If CLAUDE.md exists with markers,
read the content between `<!-- nyann:start -->` and
`<!-- nyann:end -->`. If no markers exist, note that a new block will
be appended.

## 3. Confirm before writing

Ask: "Regenerate the nyann-managed block in CLAUDE.md?"

Show what will feed into the generation (profile name, stack,
storage strategy) so the user can verify the inputs are correct.
Skip the confirmation only when the user said "just do it".

## 4. Run the generator

On confirmation:

```
bin/gen-claudemd.sh \
  --profile <profile-path> \
  --doc-plan <doc-plan-path> \
  [--stack <stack-path>] \
  [--workspace-configs <ws-path>] \
  [--project-name <name>] \
  --target <cwd>
```

The script writes CLAUDE.md in-place — content outside markers is
preserved verbatim.

If the script warns about the 3 KB soft cap, relay the warning and
suggest `/nyann:optimize-claudemd` as a follow-up.

If the script refuses at the 8 KB hard cap, explain and offer
`--force` to override.

## 5. Report

- Before/after diff of the managed block.
- Byte count of the managed block.
- Whether user content outside markers was preserved (always yes).

## When to hand off

- "Optimize CLAUDE.md based on usage" → `optimize-claudemd` skill.
- "What does nyann see in this repo?" → `explain-state` skill.
- "Check if my repo is healthy" → `doctor` skill.
- "Switch to a different profile" → `migrate-profile` skill
  (which calls gen-claudemd internally after the switch).