docs/plans/templates/slate-plan.md
Objective: TODO: Write the exact active Slate Plan lane objective after creating this file.
Goal plan: {{PLAN_PATH}}
Template: {{TEMPLATE_PATH}}
Completion threshold:
node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}} passes.Verification surface:
plate-2; any Slate v2 source/runtime/browser/API
claim must cite and verify the live .tmp/slate-v2 workspace command.Constraints:
no extra constraints.Boundaries:
docs/plans/**, docs/research/**,
docs/slate-issues/**, docs/slate-v2/ledgers/**,
docs/slate-v2/references/**.Blocked condition:
Slate Plan lane state:
Current verdict:
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 every Slate Plan
completion gate below is satisfied and
node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}} passes.Start Gates:
| Gate | Applies | Evidence |
|---|---|---|
| Skill analysis before edits | pending | pending |
| Active goal checked or created | pending | pending |
| Source of truth read before edits | pending | pending |
docs/solutions checked for non-trivial existing-code work | pending | pending |
Live .tmp/slate-v2 grounding needed for current-state claims | pending | pending |
Work Checklist:
Completion Gates:
| Gate | Applies | Required action | Evidence |
|---|---|---|---|
| Named verification threshold | pending | Run the command, proof, source audit, or artifact check named in this plan | pending |
| Slate v2 source, runtime, browser, package, public API, or issue-fix claim | pending | Record live .tmp/slate-v2 command/proof or mark as planning-only with reason | pending |
| Issue ledger or PR reference changed | pending | Sync the relevant ledger/reference row or record why no sync applies | pending |
| Autoreview for uncommitted implementation changes | pending | Load .agents/skills/autoreview/SKILL.md and follow its dirty-local target selection until no accepted/actionable findings, or record N/A for planning-only/no local patch | pending |
| Final user-review handoff | pending | Emit final handoff or keep the plan pending with the next pass | pending |
| Goal plan complete | yes | Run node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}} | pending |
Phase / pass table:
| Phase | Status | Evidence | Next |
|---|---|---|---|
| Current-state read and initial score | in_progress | created plan | related issue discovery |
| Related issue discovery | pending | issue-ledger pass | |
| Issue-ledger pass | pending | intent/boundary pass | |
| Intent/boundary and decision brief | pending | research refresh | |
| Research, ecosystem strategy, live-source refresh | pending | pressure passes | |
| Performance/DX/migration/regression/simplicity pressure passes | pending | objection ledger | |
| Slate maintainer objection ledger | pending | high-risk pass | |
| High-risk deliberate mode | pending | ecosystem maintainer pass | |
| Ecosystem maintainer pass | pending | revision pass | |
| Revision pass | pending | issue sync accounting | |
| Issue sync accounting | pending | closure score and final gates | |
| Closure score and final gates | pending | final handoff |
Scorecard:
| Dimension | Weight | Score | Evidence |
|---|---|---|---|
| React 19.2 runtime performance | 0.20 | pending | |
| Slate-close unopinionated DX | 0.20 | pending | |
| Plate and slate-yjs migration backbone | 0.15 | pending | |
| Regression-proof testing strategy | 0.20 | pending | |
| Research evidence completeness | 0.15 | pending | |
| shadcn-style composability and minimalism | 0.10 | pending |
Source-backed architecture north star:
Public API target:
| Surface | Proposed shape | User-facing DX | Compatibility / migration | Evidence | Verdict |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
Internal runtime target:
| Layer | Current owner | Target mechanism | Avoids | Evidence | Verdict |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
Hook / component / render DX target:
| Surface | Call-site shape | Composition rule | Performance rule | Evidence | Verdict |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
Plate migration-backbone target:
| Pressure | Slate substrate target | Plate adaptation route | Non-goal | Evidence | Verdict |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
slate-yjs migration-backbone target:
| Pressure | Slate substrate target | Collaboration route | Non-goal | Evidence | Verdict |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
Intent / boundary record:
Decision brief:
Issue accounting:
| Issue / cluster | Claim category | Exact claim | Why | Proof route | V2 sync ledger | PR line |
|---|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending | pending |
Issue-ledger sync status:
Ecosystem strategy synthesis:
| System | Source | Mechanism | Avoids | Steal | Reject | Slate target | Verdict |
|---|---|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending | pending | gap |
Legacy regression proof matrix:
| Regression class | Legacy behavior | Slate v2 target | Proof route | Owner | Status |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
Browser stress / parity strategy:
| Surface | Scenario | Browser/device | Command or proof route | Expected signal | Status |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
Verification workspace gate:
| Claim | Workspace | Command | Result | Owner |
|---|---|---|---|---|
| pending | pending | pending | pending | pending |
Applicable implementation-skill review matrix:
| Lens | Applies | Status | Findings | Plan delta |
|---|---|---|---|---|
| vercel-react-best-practices | pending | pending | ||
| performance-oracle | pending | pending | ||
| performance | pending | pending | ||
| tdd | pending | pending | ||
| shadcn | pending | pending | ||
| react-useeffect | pending | pending |
High-risk deliberate-mode pre-mortem:
| Risk | Trigger | Failure mode | Mitigation | Proof | Status |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
Slate maintainer objection ledger:
| Change | Objection | Tradeoff | Evidence | Migration/docs/proof answer | Verdict |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
Hard cuts and rejected alternatives:
| Option / API | Keep / cut / reject | Why | Migration cost | Evidence | Follow-up |
|---|---|---|---|---|---|
| pending | pending | pending | pending | pending | pending |
Plan deltas from review:
Open questions and decision-changing evidence:
| Question | Why it matters | Evidence needed | Owner | Status |
|---|---|---|---|---|
| pending | pending | pending | pending | pending |
Implementation phases with owners:
| Phase | Owner | Scope | Entry criteria | Exit criteria | Verification |
|---|---|---|---|---|---|
| pending | slate-plan execution mode | pending | pending | pending | pending |
Fast driver gates:
| Gate | Cwd | Command / artifact | Proves | Status |
|---|---|---|---|---|
| planning artifact check | plate-2 | pending | plan/template integrity | pending |
| Slate v2 behavior check | .tmp/slate-v2 | pending | runtime/API/browser behavior | pending |
Final user-review handoff outline:
Final completion gates:
| Gate | Required evidence | Status |
|---|---|---|
| score >= 0.92 and no dimension below 0.85 | scorecard rows cite evidence | pending |
| all pass rows complete or skipped with evidence | phase/pass table closed | pending |
| issue/reference sync closed | issue-ledger sync status closed | pending |
| live source grounding complete | source-backed rows cite current owners | pending |
| workspace verification recorded | verification workspace gate closed | pending |
| autoreview clean or N/A | .agents/skills/autoreview/SKILL.md loaded and clean for non-trivial uncommitted implementation changes, or N/A with reason | pending |
| final handoff emitted or lane remains pending | final response / next pass recorded | pending |
check-complete passes | node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}} | pending |
Findings:
Decisions and tradeoffs:
Error attempts:
| Error / failed attempt | Count | Next different move | Resolution |
|---|---|---|---|
| None yet | 0 |
External/browser findings:
Timeline:
Verification evidence:
Reboot status:
| Question | Answer |
|---|---|
| Where am I? | Current-state read and initial score |
| Where am I going? | Run the next incomplete Slate Plan pass |
| What is the goal? | TODO: Fill from Objective |
| What have I learned? | See Findings |
| What have I done? | See Timeline |
Open risks: