From realm
Conversation-to-vault ADR bridge. Extracts decisions, rejected alternatives, and discoveries from the current conversation, runs a structured interview per decision, then writes a manifest draft directly — no codebase scan. One command to capture session knowledge as ADR and discovery nodes.
How this skill is triggered — by the user, by Claude, or both
Slash command
/realm:realm-conveyThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Extract decisions from conversation → structured ADR interview → manifest-draft → vault.
Extract decisions from conversation → structured ADR interview → manifest-draft → vault.
| Trigger | Example |
|---|---|
| Made an architectural decision | "convey this", /realm-convey |
| Discussed tradeoffs and chose a direction | "push this decision to realm" |
| End of session with non-obvious choices | "log this session" |
Finished a /realm-plan that produced decisions | "convey the decisions from this plan" |
/realm-forge first (hard guard)/realm-fathom/realm-recallSteps 0–2.5 run inline (require main conversation context and user interaction). Step 3 is an interactive interview — no agents spawned. Step 4 writes manifest-draft directly. No codebase scan.
.realm/realm-state.json. If missing: No realm state. Run /realm-forge first. STOP.vaultPath, projectSlug, projectDir.Scan current conversation context (all turns). Apply caveman compression:
Output: compressed flat list of meaningful items discussed.
Classify each item:
| Type | Signal | Action |
|---|---|---|
decision | "decided to", "chose X over Y", "because", "instead of", "DO NOT", "rejected", "went with" | ADR candidate → structured interview (Step 3) |
discovery | perf finding, unexpected behavior, bug post-mortem, tech constraint, "turns out" | discovery node stub |
session | general session summary, what was worked on | session log entry |
Functions and classes are not captured here. Code entities are derivable from source — only capture what code cannot express: decisions, rationale, rejected alternatives, constraints.
Present pick-list. Do not proceed until user replies.
realm-convey: select items to capture
Decisions
[1] <decision title> — <one-liner>
[2] <decision title> — <one-liner>
Discoveries
[3] <discovery title> — <one-liner>
Session log
[4] this session — <summary one-liner>
Enter numbers (e.g. 1 3), "all", or "none" to cancel:
Rules:
all → select every itemnone / empty → Nothing selected. Vault unchanged. STOPFor each selected decision, present this block and wait for user reply before moving to the next:
Decision [N/total]: <title>
Answer each — skip any you don't know yet (just press enter):
1. What exactly was decided?
2. What alternatives were considered, and why was each rejected?
3. What constraints or consequences does this impose on future work?
4. What triggered this? (PR, bug, requirement, conversation, spike)
Use answers to populate ADR node fields. Skipped fields become — placeholders.
After all decisions are interviewed, proceed to Step 4.
Write <projectRoot>/.realm/manifest-draft.md containing:
ADR node body structure:
## Context
<what triggered this — from interview answer 4>
## Decision
<what was decided — from interview answer 1>
## Rejected alternatives
<each alternative + reason rejected — from interview answer 2>
## Consequences
<constraints imposed, known tradeoffs — from interview answer 3>
Register draft:
python3 "${HOME}/.claude/plugins/marketplaces/realm/scripts/manifest_write.py" \
--project-root "<projectRoot>" \
--push-draft \
--draft-path ".realm/manifest-draft.md" \
--source convey
If exit code non-zero: surface error. STOP.
realm-convey complete
decisions captured: <N> (ADR nodes staged in manifest-draft.md)
discoveries: <N>
session log: <yes|no>
draft: .realm/manifest-draft.md
next: /realm-manifest to write to vault
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub blackmo18/realm --plugin realm