From a1489d984c67ccf9580ed814b3385790f0b337b4 Mon Sep 17 00:00:00 2001
From: hjbrandt <34381881+hjbrandt@users.noreply.github.com>
Date: Thu, 27 Aug 2026 18:57:01 +0200
Subject: [PATCH] docs(da): note that the migration plan predates the
 single-file schema

Section 1 records that the sibling `DA_IDENTITY.yaml` regenerated by
`DAIdentityGenerator.ts` was retired because the two-file split "made every
edit a sync hazard", and states the design as one `DA_IDENTITY.md` carrying
the schema in frontmatter and the narrative in the body.

Section 9 still describes migrating into that retired split: step 2 writes
`DA_IDENTITY.yaml` and generates a `DA_IDENTITY.md` "for backward compat",
and step 6 deprecates the markdown in favour of the YAML. It also invokes
`LIFEOS/TOOLS/MigrateDAIdentity.ts`, which is not in the release payload.

Adds a short note in the same style as the existing "Path note." above, so a
reader following section 9 does not recreate the split section 1 removed. No
change to the steps themselves.
---
 LifeOS/install/LIFEOS/DOCUMENTATION/Pulse/DaSubsystem.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/LifeOS/install/LIFEOS/DOCUMENTATION/Pulse/DaSubsystem.md b/LifeOS/install/LIFEOS/DOCUMENTATION/Pulse/DaSubsystem.md
index 04fc5135ab..7fa27461be 100644
--- a/LifeOS/install/LIFEOS/DOCUMENTATION/Pulse/DaSubsystem.md
+++ b/LifeOS/install/LIFEOS/DOCUMENTATION/Pulse/DaSubsystem.md
@@ -1095,6 +1095,12 @@ Tasks:
 
 ## 9. Migration Plan
 
+> **Format note.** This plan was drafted while the schema still lived in a sibling
+> `DA_IDENTITY.yaml`. Section 1 retired that two-file split — the schema is now YAML
+> frontmatter inside `DA_IDENTITY.md` itself. Read the steps below that write or
+> deprecate a `.yaml` as writing the frontmatter of the single file. `MigrateDAIdentity.ts`
+> is not part of the release payload.
+
 ### Step-by-Step Migration for the primary DA
 
 ```