Back to Oh My Openagent

Lane D: Memory, Debt & Handoff

packages/shared-skills/skills/frontend/references/designpowers/lane-d-memory.md

4.14.15.0 KB
Original Source

Lane D: Memory, Debt & Handoff

Lane D records the design record around OpenAgent work. It owns .omo/frontend-design/state.md, design debt, handoff notes, retrospective notes, and observational taste memory. It has no hooks and no independent automation path. It records and summarizes what happened so the next OpenAgent phase has reliable context.

Phase Owner

CapabilitySource boundaryownerMapping
Track deferred design and accessibility findingsdesign-debt-tracker.omo/frontend-design/state.md plus final review-work contextMaintain a register with ID, date, source, severity, issue, affected users, suggested fix, status, and notes.
Package design rationale for implementers or reviewersdesign-handoffstart-work and review-work contextRecord component, interaction, accessibility, content, and rationale notes that workers or reviewers need.
Reflect on process after completiondesign-retrospectivefinal handoff contextRecord what worked, what did not, fix rounds, debt health, and lessons.
Maintain observational design memoryAuthored concept preserved from excluded raw design-memory.omo/frontend-design/state.md and optional personal report contextStore observations descriptively. Do not feed them back as future project constraints.
Produce a taste reflection when requestedtaste-reportuser-facing handoff onlySummarize personal-layer observations only when enough evidence exists or the user asks.
Route designpowers concepts into frontendAuthored router semantics only; raw using-designpowers is excludedfrontend designpowers reference contextFrontend router owns routing and mode language; no raw upstream router path or separate runtime is available.

Materialized source agents are not primary in this lane. Lane D records outputs from design-strategist, design-lead, motion-designer, content-writer, design-critic, accessibility-reviewer, and heuristic-evaluator when those role references contributed context in earlier lanes.

State File

Lane D's state target is:

text
.omo/frontend-design/state.md

The state file should stay scannable and append-friendly:

  • current objective and locked decisions
  • source inputs and explicit exclusions
  • brief summary, personas, design principles, taste signals, and success criteria when available
  • decisions log with rationale
  • open questions
  • artifact index
  • design debt register
  • handoff notes
  • retrospective notes or links
  • evidence index

Prompt Injection

Append this block when closing a planning, implementation, review, or handoff phase:

text
Apply Lane D Memory, Debt & Handoff.

Update `.omo/frontend-design/state.md` with:
- decisions made in this phase and the rationale
- any open design questions or owner decisions
- artifact paths and evidence paths
- design debt from deferred Minor or Note findings, including affected users and suggested fixes
- accessibility debt status and explicit user acknowledgement if accepted
- handoff notes for the next owner
- retrospective observations when work is complete

Do not use design memory as a rule source for future work. Record observations as descriptive evidence only.
No hooks or independent automation are available in this lane.

Evidence Requirements

Lane D passes only when the record is inspectable:

  • .omo/frontend-design/state.md exists before a lane claims durable state.
  • Design debt entries include ID, source, severity, affected users, suggested fix, status, and notes.
  • Accessibility debt is either resolved or explicitly acknowledged by the user before acceptance.
  • Handoff notes cite concrete artifacts, decisions, constraints, and evidence paths.
  • Retrospective notes cite the final verification artifacts, unresolved debt, and lessons from fix rounds or user overrides.
  • The evidence index points to real files produced by OpenAgent planning, start-work, visual-qa, or review-work.

Guardrails

  • Lane D records state; it does not mutate implementation or run hidden work.
  • The design debt register must not capture Critical or Major blockers as ordinary debt. Those require repair, escalation, or explicit blocking status.
  • Accepted debt requires a rationale. Accepted accessibility debt requires explicit user acknowledgement.
  • Design memory is a mirror, not a steering wheel: it describes how decisions happened and must not silently constrain another project.
  • Handoff text must be useful to the next owner, not a narrative transcript.
  • No hooks, background schedulers, or extra runtime contracts are part of this lane.

Pass / Fail Behavior

PASS when state, design debt, handoff, retrospective, and evidence references are current enough for ulw-plan, start-work, visual-qa, or review-work to resume without guessing.

FAIL when deferred findings disappear, accessibility debt is accepted without acknowledgement, handoff omits artifact paths, state is stale, retrospective claims lack evidence, or memory is used as prescriptive design input.