docs: retrofit architecture documentation to multi-DNA reality (#113) - #116
Open
Soushi888 wants to merge 1 commit into
Open
docs: retrofit architecture documentation to multi-DNA reality (#113)#116Soushi888 wants to merge 1 commit into
Soushi888 wants to merge 1 commit into
Conversation
- ARCHITECTURE_COMPONENTS.md: multi-DNA executive summary and topology diagram (Lobby, Group, NDO, hREA roles alongside the 3-zome core); PPR category count corrected to 16; ADR-001 status note; new ADR-013 recording the DNA split - README.md: multi-DNA overview and architecture section, development status records #103/#107/#111 and the in-progress #112, per-DNA Sweettest suites - DOCUMENTATION_INDEX.md: zome_lobby described as the group registry (NDO announcements were removed in #107); paths fixed for files moved by #111 (lobby-architecture.md, lobby-dna.md, ndo-versioning.md); status labels updated - lobby-architecture.md: supersession banner — shipped registry model is inverted (Lobby registers groups); NdoAnchor resurrects the NdoDescriptor idea at group level, keeping the decision trail honest - lobby-dna.md: implementation notes and REQ-LOBBY-04..06 statuses reflect the #107 removal of NdoAnnouncement; section 10 state tables rewritten to current reality (#103/#107/#111 shipped, #112/#110 in progress) - ui_architecture.md: group-scoped Lobby description; conductor diagram lists all five DNA roles - documentation/README.md: lobby and group zome docs linked - TEST_COMMANDS.md, Testing_Infrastructure.md: stale announce_ndo test references replaced with real lobby test names
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Implements #113: retrofits the architecture documentation to the multi-DNA reality (Lobby DNA #103, Group DNA #107, DHT-backed UI #111, NDO DNA #112 in flight). The 2026-07-19 docs audit found the core docs still describing a single 3-zome DNA with localStorage groups; several audit items had already been fixed by #111, so each item was re-verified against current
devbefore editing.Changes
P1 (actively misleading):
ARCHITECTURE_COMPONENTS.md: multi-DNA executive summary and high-level diagram (all five DNA roles); 16 PPR categories (was 14); ADR-001 status note plus a new ADR-013 recording the DNA split and its rationale (complexity matching, REQ-RES-02, DNA-hash-as-identity)README.md: multi-DNA overview, architecture section, development status (feat(dna): Lobby DNA multi-network federation entry point with Sweettest suite #103/feat(dna): Group DNA per-group coordination DHT with Sweettest suite #107/feat(ui): DNA-backed groups, multi-agent web harness, and NDO layer-0 UI #111 shipped, feat(dna): NDO DNA role, per-NDO cell cloning, NdoAnchor in zome_group #112 in progress), per-DNA Sweettest suite listspecifications/lobby-architecture.md: supersession banner — the shipped registry model is inverted relative to this design (Lobby registers groups, not NDOs); the NDO-per-cell design partially resurrects theNdoDescriptoridea as the group-levelNdoAnchor, stated explicitly to keep the decision trail honestrequirements/lobby-dna.md: implementation notes and REQ-LOBBY-04..06 statuses now reflect the feat(dna): Group DNA per-group coordination DHT with Sweettest suite #107 removal ofNdoAnnouncement; section 10 (current state / next steps) rewritten to current realityspecifications/ui_architecture.md: group-scoped Lobby description (no global NDO registry); conductor diagram lists all five DNA rolesP2 (incomplete):
DOCUMENTATION_INDEX.md:zome_lobbycorrectly described as the group registry; paths fixed for files moved/renamed by feat(ui): DNA-backed groups, multi-agent web harness, and NDO layer-0 UI #111 (lobby-architecture.md,lobby-dna.md,ndo-versioning.md); status labels updateddocumentation/README.md: links tozomes/lobby_zome.mdandzomes/group_zome.mdTEST_COMMANDS.md,Testing_Infrastructure.md: staleannounce_ndotest references replaced with real lobby suite namesNot touched (already accurate):
zomes/lobby_zome.mdandzomes/group_zome.md(the latter gains NdoAnchor in #115, not here).ui_design.mdandIMPLEMENTATION_STATUS.mdaudit items were already fixed by #111.Sequencing
Merge after #115 so the ndo-role references (ADR-013, README status, index) document merged reality. No code changes.
Closes #113