docs/plans/2026-05-24-expand-slate-ralplan-template-artifacts.md
Objective:
Move Slate Ralplan plan-artifact ledger shape from
.agents/rules/slate-ralplan.mdc into
docs/plans/templates/slate-ralplan.md, complete only when the template seeds
every required Plan Shape artifact as concrete headings, tables, and placeholders
while the rule remains policy/execution guidance, generated Slate Ralplan
scratchpads contain those sections, source/generated output is synced as needed,
stale gap checks are clean, pnpm lint:fix passes, and this plan passes
check-complete.
Goal plan: docs/plans/2026-05-24-expand-slate-ralplan-template-artifacts.md
Completion threshold:
docs/plans/templates/slate-ralplan.md includes concrete placeholder
sections for all 25 Slate Ralplan Plan Shape artifacts; .agents/rules
keeps policy and execution semantics; generated Slate Ralplan scratchpad smoke
contains representative required sections; pnpm install, smoke checks,
pnpm lint:fix, and this plan's check-complete pass.Verification surface:
rg / generated scratchpad section checks, node --check for goal helper
scripts, Slate Ralplan template render smoke, expected incomplete-plan
rejection, pnpm install, pnpm lint:fix, and final
node .agents/rules/goal/scripts/check-complete.mjs docs/plans/2026-05-24-expand-slate-ralplan-template-artifacts.md.Constraints:
SKILL.md by hand; do not edit Slate v2
implementation files; keep Slate Ralplan a planning/review gate; keep policy
prose in .agents/rules/slate-ralplan.mdc and ledger scaffolding in the
template.Boundaries:
docs/plans/templates/slate-ralplan.md,
.agents/rules/slate-ralplan.mdc if policy wording needs adjustment,
generated output from pnpm install, and this goal plan.Blocked condition:
Completion rule:
update_goal(status: complete) while any required checklist item
remains unchecked. If an item does not apply, check it and add N/A: <reason>.update_goal(status: complete) until the named verification
evidence is recorded below and
node .agents/rules/goal/scripts/check-complete.mjs docs/plans/2026-05-24-expand-slate-ralplan-template-artifacts.md passes.active goal state for this goal. This
file plus the active goal are the durable state.Required checklist:
get_goal checked; create_goal called only when no active goal existed,
or the active matching goal was recorded.learnings-researcher / docs/solutions checked, or marked N/A with
reason. N/A: workflow/template artifact correction, not product bug reuse.docs/plans goal plan created before substantive edits.check run before PR create/update, or marked N/A with reason. N/A:
no PR requested.node .agents/rules/goal/scripts/check-complete.mjs docs/plans/2026-05-24-expand-slate-ralplan-template-artifacts.md
passes after final evidence is recorded.ce-compound evaluated after non-trivial verified work. N/A: workflow
template change is already durable in the rule/template files.Phase / pass table:
| Phase | Status | Evidence | Next |
|---|---|---|---|
| Intake and source read | complete | user request, Slate Ralplan rule, and existing template read | patch template |
| Implementation | complete | expanded Slate Ralplan template with required plan-shape artifacts and adjusted rule wording | sync generated output |
| Verification | complete | pnpm install, script syntax, generated Slate scratchpad smoke, incomplete-plan rejection, sync marker rg, and lint passed | done |
| Closeout | complete | final response reports updated template split and verification | done |
Findings:
.agents/rules/slate-ralplan.mdc, reusable plan
ledger skeleton in docs/plans/templates/slate-ralplan.md.Decisions and tradeoffs:
pending placeholders instead of copying long
policy prose into the template.Error attempts:
| Error / failed attempt | Count | Next different move | Resolution |
|---|---|---|---|
| None yet | 0 |
External/browser findings:
Timeline:
docs/plans/templates/slate-ralplan.md: verdict, north star, API/runtime/DX
targets, Plate/slate-yjs migration targets, regression/browser matrices,
high-risk pre-mortem, hard cuts, open questions, implementation phases, fast
driver gates, handoff outline, and final completion gates..agents/rules/slate-ralplan.mdc to say
the template seeds required plan-shape sections as concrete placeholders.pnpm install synced generated
.agents/skills/slate-ralplan/SKILL.md.check-complete rejected the
unfilled smoke plan as expected; smoke file was removed.pnpm lint:fix passed with no fixes applied.Verification evidence:
pnpm install -> passed; skiller apply completed successfully.node --check .agents/rules/goal/scripts/create-goal-scratchpad.mjs and
node --check .agents/rules/goal/scripts/check-complete.mjs -> passed.node .agents/rules/goal/scripts/create-goal-scratchpad.mjs --template slate-ralplan --title "smoke expanded slate ralplan template" --path docs/plans/2026-05-24-smoke-expanded-slate-ralplan-template.md -> generated a Slate Ralplan plan from the updated template.rg --fixed-strings checks found these generated sections:
Current verdict, Source-backed architecture north star,
Public API target, Internal runtime target,
Hook / component / render DX target, Plate migration-backbone target,
slate-yjs migration-backbone target, Legacy regression proof matrix,
Browser stress / parity strategy, High-risk deliberate-mode pre-mortem,
Hard cuts and rejected alternatives,
Open questions and decision-changing evidence,
Implementation phases with owners, Fast driver gates,
Final user-review handoff outline, and Final completion gates.node .agents/rules/goal/scripts/check-complete.mjs docs/plans/2026-05-24-smoke-expanded-slate-ralplan-template.md -> rejected the unfilled generated plan as expected; the smoke file was removed.rg --fixed-strings "required plan-shape sections" .agents/rules/slate-ralplan.mdc .agents/skills/slate-ralplan/SKILL.md -> found synced source and generated skill wording.rg -n "Plan Shape|Source-backed architecture north star|Final completion gates" docs/plans/templates/slate-ralplan.md -> confirmed template contains plan-shape sections.pnpm lint:fix -> passed; Checked 3423 files in 5s. No fixes applied.node .agents/rules/goal/scripts/check-complete.mjs docs/plans/2026-05-24-expand-slate-ralplan-template-artifacts.md -> passed with [goal] complete: docs/plans/2026-05-24-expand-slate-ralplan-template-artifacts.md.Reboot status:
| Question | Answer |
|---|---|
| Where am I? | Closeout |
| Where am I going? | Report updated Slate Ralplan template and verification |
| What is the goal? | Make new Slate Ralplan plans start with all required plan-artifact sections |
| What have I learned? | See Findings |
| What have I done? | See Timeline |
Open risks: