T-RXUK-reconcile-d0004-with-s0005-body-artifact

Status: closed/done · Impact: low · Complexity: small

Goal

The retire PR (#491) rewrote S-0005 so the entity body artifact is the contract(...) in <type>/schema.ts. But the decision record docs/planning/decisions/D-0004*.md (status open/accepted) still lists body-schema.yaml as a required entity artifact (around lines 28, 51, and 114), which now contradicts the current S-0005. Reconcile the two so the still-accepted decision is consistent with the live standard.

Today

Location	Role today
`docs/planning/decisions/D-0004-entity-definition-architecture.md`	Status `open/accepted`; lists `body-schema.yaml` as a required entity artifact (28, 51, and the table row at 114), contradicting current S-0005 (body artifact = the `contract(...)` in `schema.ts`). Lines 217/238/245 discuss it as historical reasoning
`docs/planning/decisions/D-B4CA-term-entity-and-generated-glossary.md`	Mentions `body-schema.yaml`; AC-2 verify it is a historical mention, not a live claim
`docs/planning/decisions/D-7F2M-why-what-verify-chain.md`	Mentions `body-schema.yaml`; AC-2 verify
`docs/planning/decisions/D-0009-reference-entity-and-docs-appendix.md`	Mentions `body-schema.yaml`; AC-2 verify

Approach

Reconcile the still-accepted decision with the live standard; docs only.

Update D-0004 at lines 28/51/114 so body-schema.yaml is no longer listed as a live required artifact — replace with the contract(...) in schema.ts, or add an amended note dated to the retire PR (#491). Keep the 217/238/245 discussion as historical record.
Decide D-0004’s status: kept open/accepted needs only an in-place amendment; if superseded, carry a valid completion_note per the decision schema.
AC-2: check D-B4CA, D-7F2M, D-0009 — they mention body-schema.yaml in passing; leave them unless one asserts it as a live artifact.
sdlc entities validate on the edited decision(s) stays green.

Files to touch

Location	Kind	Change
`docs/planning/decisions/D-0004-entity-definition-architecture.md`	modify	Repoint the `body-schema.yaml` live-artifact claims (28/51/114) to the `schema.ts` contract; reconcile with S-0005; keep the historical discussion

Acceptance criteria

AC-1: D-0004 is updated (or carries a superseded/amended note) so it no longer lists body-schema.yaml as a live required entity artifact and is consistent with S-0005’s contract-in-schema.ts position.
AC-2: No other decision record under docs/planning/decisions/ still claims body-schema.yaml as a live artifact (verified by grep).
AC-3: D-0004 still validates (sdlc entities validate) and, if its status is changed, carries a valid completion_note/supersession per the decision schema.

Out of scope

The prose-doc fixes in entity definition.md files, README.md, and the convention checklists — those are covered by the stale-doc-claims cleanup task.

← Back to Tasks