docs/plans/templates/sync-plate-ui.md
Objective:
TODO: Write the exact active sync-plate-ui objective after creating this file.
Flow mode: Planning mode by default: one-shot execution to write a reviewable downstream Plate UI sync plan and stop for user acceptance. Apply mode starts only on a later user instruction that accepts a named plan, dashboard payload, component, or row. Collaborative planning applies only when the user is deciding target fork policy.
Goal plan: {{PLAN_PATH}}
Primary template: docs/plans/templates/sync-plate-ui.md
Applied packs:
agent-native if .agents/**, .claude/**, .codex/**, skills,
commands, prompts, or user-action tooling are editedbrowser if accepted target implementation changes a visible routepackage-api if target package/API boundaries are changedSync source:
/Users/zbeyens/git/plateapps/www/src/registry/**apps/www/src/registry/changelog/{index,components,<event-id>}.json
or /registry/changelog/{index,components,<event-id>}.json<target>/.plate-ui-sync/status.json<target>/.plate-ui-sync/runs/<date>-<scope>/First checkpoint:
Completion threshold:
node .agents/skills/autogoal/scripts/check-complete.mjs {{PLAN_PATH}}.Verification surface:
components.json, package.json, lockfile/package
manager, aliases, and existing sync scripts.plan.md, inventory.json, inventory.md,
component-diffs.md, target-files.txt, decision-counts.json..plate-ui-sync/dashboard.json and
.plate-ui-sync/dashboard.md.Constraints:
sync-plate-ui is
downstream-consumer tooling only.build:registry..patch files into target sync artifacts.Boundaries:
.plate-ui-sync/**
artifacts.Output budget strategy:
.plate-ui-sync.
Do not stream full registry trees or broad diffs into chat.Blocked condition:
Sync 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 planning or apply evidence
is recorded below and
node .agents/skills/autogoal/scripts/check-complete.mjs {{PLAN_PATH}}
passes.Start Gates:
| Gate | Applies | Evidence |
|---|---|---|
| Prompt requirements captured before work | pending | pending |
autogoal loaded and active goal checked/created | pending | pending |
sync-plate-ui rule read | pending | pending |
| Output budget strategy recorded | pending | pending |
| Target repo path resolved | pending | pending |
Target components.json read | pending | pending |
| Target package manager and aliases read | pending | pending |
Target .plate-ui-sync/status.json read or bootstrap mode recorded | pending | pending |
| Plate registry item/source mapped | pending | pending |
| Component changelog evidence read or fallback weakness recorded | pending | pending |
| Target component files mapped | pending | pending |
| Planning versus apply mode decided | pending | pending |
| User-review boundary recorded | pending | pending |
Work Checklist:
.plate-ui-sync/runs/**.Completion Gates:
| Gate | Applies | Required action | Evidence |
|---|---|---|---|
| Named verification threshold | pending | Prove the planning or apply threshold named above | pending |
| Target config mapped | pending | Record target package manager, aliases, registry paths, and trusted/untrusted sync scripts | pending |
| Component source mapped | pending | Record Plate registry item, Plate files, target files, and changelog evidence | pending |
| Inventory completeness | pending | Reconcile inventory row count with scoped component/file set | pending |
| Hunk classification | pending | Record base/upstream/local class for every changed hunk or explicit unknown-base blocker | pending |
| Decision accounting | pending | Verify every row has a decision and real questions are isolated | pending |
| Planning-only no target source edits | pending | Verify planning did not mutate target source, or record accepted apply mode | pending |
| Dashboard artifacts | pending | Write dashboard JSON/Markdown when requested, otherwise N/A | pending |
| Apply revalidation | pending | In apply mode, recompute accepted rows before mutation; otherwise N/A | pending |
| Target verification | pending | In apply mode, run target-owned focused checks; otherwise N/A | pending |
| Browser surface changed | pending | Capture browser proof for visible target changes; otherwise N/A | pending |
| Package manifests, lockfile, or install graph changed | pending | Run target package-manager install/checks when touched; otherwise N/A | pending |
| User review boundary | pending | In planning mode, stop and ask the user to accept rows; in apply mode, record accepted payload | pending |
| Output budget discipline | pending | Verify broad output was artifacted/capped, or record accidental output and recovery | pending |
| Autoreview | pending | For non-trivial apply runs, load .agents/skills/autoreview/SKILL.md and close accepted/actionable findings; for planning-only or no-local-patch runs, record N/A with reason | pending |
| Goal plan complete | yes | Run node .agents/skills/autogoal/scripts/check-complete.mjs {{PLAN_PATH}} | pending |
Phase / pass table:
| Phase | Status | Evidence | Next |
|---|---|---|---|
| Intake and target read | in_progress | created plan | source mapping |
| Source mapping | pending | classification | |
| Classification and fork ledger | pending | plan artifact | |
| Dashboard / user review artifact | pending | user review stop | |
| Accepted apply | pending | verification or N/A | |
| Verification and status update | pending | closeout | |
| Closeout | pending | final response |
Decision counts:
| Decision | Count | Notes |
|---|---|---|
pull-upstream | pending | pending |
keep-fork | pending | pending |
smart-merge | pending | pending |
reject-upstream | pending | pending |
delete-target-residue | pending | pending |
package-only | pending | pending |
needs-question | pending | pending |
no-op | pending | pending |
Apply rows:
| Row | Action | Files | Why | Verification |
|---|---|---|---|---|
| pending | pending | pending | pending | pending |
Questions:
Findings:
Decisions and tradeoffs:
Error attempts:
| Error / failed attempt | Count | Next different move | Resolution |
|---|---|---|---|
| None yet | 0 |
Verification evidence:
Final handoff:
Timeline:
Reboot status:
| Question | Answer |
|---|---|
| Where am I? | Intake and target read |
| Where am I going? | Source mapping, classification, artifact, review/apply, verification |
| What is the goal? | TODO: Fill from Objective |
| What have I learned? | See Findings |
| What have I done? | See Timeline |
Open risks: