Plans & Makers
Plan helper, skill/rule/plan/theme makers, and chat annotations.
BLXAde includes Maker tools for authoring structured project artifacts and a read-only Plan helper node for reviewing plans with Mermaid diagrams.
Plan helper node
A hidden Helper (not in the Open menu) that opens a plan file:
.agents/plans/<slug>.mdUI
- Calm read-only Markdown body
- Outline rail (H2/H3) with scroll-spy; compact selector on narrow widths
- Mermaid diagrams rendered offline to sanitized SVG (no network)
- Default large node size (~900×600)
Canvas stores only kind + plan path — not source, SVG, or annotations.
Open paths
- Global Agent / Agent CLI
plan_node_controlorplan_makersuccess path - Voice phrases like “open plan …” (EN/DE)
- Explicit plan path (not confused with general Markdown View)
Maker tools (Global + Agent CLI)
Closed-world tools — not available to External MCP:
| Tool | Writes under |
|---|---|
skill_maker | .agents/skills/<slug>/ |
rule_maker | .agents/rules/<slug>.md (+ managed AGENTS.md registry block) |
plan_maker | .agents/plans/<slug>.md + INDEX.md row; opens Plan helper |
theme_maker | ~/.blxade/themes/<id>/ manifest + CSS (refreshes catalog; does not auto-activate) |
plan_node_control | Open / focus / close Plan view only |
Every maker supports list / read / create / revision-guarded update. No delete/rename/clear tools. Paths are sandbox-validated (no absolute/UNC escape).
Plan document rules
Plans need canonical structure, milestones, stable task IDs, index row, and at least three Mermaid diagrams (architecture, runtime flow, milestone/state).
Annotations (“Add to chat”)
Selecting text in the Plan helper can attach a bounded quote + optional comment to the next Global Agent message. Attachments are temporary; success clears them. Annotated sends skip some local fast-path shortcuts so the model sees the plan context.
Markdown View vs Plan
| Surface | Paths | Purpose |
|---|---|---|
| Markdown helper | General .md in project | Read-only document presentation |
| Plan helper | .agents/plans/*.md | Structured plans + Mermaid + annotations |
Related: Agents, Appearance / custom themes, Canvas nodes.