docs: update architecture docs for addon-first model (#255) #264

forbes · 2026-02-17T18:38:51Z

forbes commented

2026-02-17 18:38:51 +00:00

Updates all three architecture documents to reflect the addon-first model implemented in #248–#254.

ARCHITECTURE.md

Bootstrap flow now shows manifest-driven loader pipeline (scan → parse → validate → resolve → load)
New addon lifecycle section with package.xml <kindred> extension documentation
Source layout includes SDK (mods/sdk/), C++ scaffold (App/, Gui/), and addon loader

INTEGRATION_PLAN.md

5-layer diagram: added Layer 4 (Addon SDK) between bootstrap and addons
Layer 3 updated: hosts both Python loader AND C++ scaffold (no longer "does not contain C++ code")
New phases: 1.5 (SDK — DONE), 1.75 (C++ scaffold — DONE)
Phase 4 (theme): centralized in SDK YAML palette
Phase 6 (build): marked DONE
New design decisions: SDK as adaptation layer, manifest-driven loading

README.md

Addon integration section: manifest-driven loading, SDK wrappers
Project structure: added mods/sdk/, updated Create module description

Closes #255.

Updates all three architecture documents to reflect the addon-first model implemented in #248–#254. ### ARCHITECTURE.md - Bootstrap flow now shows manifest-driven loader pipeline (scan → parse → validate → resolve → load) - New addon lifecycle section with package.xml `<kindred>` extension documentation - Source layout includes SDK (`mods/sdk/`), C++ scaffold (`App/`, `Gui/`), and addon loader ### INTEGRATION_PLAN.md - 5-layer diagram: added Layer 4 (Addon SDK) between bootstrap and addons - Layer 3 updated: hosts both Python loader AND C++ scaffold (no longer "does not contain C++ code") - New phases: 1.5 (SDK — DONE), 1.75 (C++ scaffold — DONE) - Phase 4 (theme): centralized in SDK YAML palette - Phase 6 (build): marked DONE - New design decisions: SDK as adaptation layer, manifest-driven loading ### README.md - Addon integration section: manifest-driven loading, SDK wrappers - Project structure: added `mods/sdk/`, updated Create module description Closes #255.

forbes added 1 commit 2026-02-17 18:38:51 +00:00

docs: update architecture docs for addon-first model (#255 )

Build and Test / build (pull_request) Failing after 2m1s

Details

252e2c3b3e

ARCHITECTURE.md:
- Replace exec()-based bootstrap flow with manifest-driven loader diagram
- Add addon lifecycle section (scan → parse → validate → resolve → load → register)
- Add SDK and C++ scaffold to source layout
- Document load order: sdk (0) → ztools (50) → silo (60)

INTEGRATION_PLAN.md:
- Add Layer 4 (Addon SDK) between bootstrap and addons (now 5 layers)
- Update Layer 3: now hosts both Python loader AND C++ scaffold
- Add Phase 1.5 (SDK) and Phase 1.75 (C++ scaffold) as DONE
- Update Phase 4 (theme): colors centralized in SDK YAML palette
- Update Phase 6 (build): now DONE with CMake install rules for all addons
- Add design decisions #7 (SDK as adaptation layer) and #8 (manifest-driven loading)

README.md:
- Update addon integration section: manifest-driven loading, SDK wrappers
- Add mods/sdk/ to project structure tree
- Update Create module description to mention C++ scaffold

Closes #255.

forbes merged commit 06c698d425 into main

2026-02-17 18:46:04 +00:00

forbes referenced this issue from a commit

2026-02-17 18:46:05 +00:00

Merge pull request 'docs: update architecture docs for addon-first model (#255)' (#264) from docs/update-architecture-for-addon-model into main

forbes deleted branch docs/update-architecture-for-addon-model

2026-02-17 18:46:05 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kindred/create#264