Skip to content

docs(architecture): write chapter 7 as the distribution view (#2410) - #2411

Merged
braboj merged 19 commits into
mainfrom
docs/ch7-distribution
Oct 30, 2026
Merged

braboj merged 19 commits into
mainfrom
docs/ch7-distribution

Conversation

@braboj

@braboj braboj commented Oct 30, 2026

Copy link
Copy Markdown
Collaborator

Chapter 7 said "not applicable". It now shows how the rules reach a project and where they run, with a deployment diagram in ImBrain's style.

Section What it covers
7.1 Level 1 Diagram and node table: upstream, a fork, the project, the developer's machine, the project's CI
7.2 Source Upstream (shared rules only) or a fork (adds stacks); moving from one to the other without regenerating
7.3 Attachment Submodule, clone, copy or hooks only, each pinned to a released tag
7.4 Update The team moves the pin; a fork may add an updater, bound by three rules (FR-08-04, FR-09-03)

Diagram notes:

  • pre-commit appears twice: on each commit (local hook, early feedback) and on each push (CI, the gate)
  • No path crosses another
  • The updater bot itself is a fork spike: Imbra-Ltd/imbra-ai-templates#68

Other changes:

  • docs/spec.md links the chapter instead of "Not applicable"

Docs-only, so no changelog entry.

Closes #2410

🤖 Generated with Claude Code

https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH

braboj and others added 19 commits October 30, 2026 08:06
- 7.1: a deployment diagram from upstream and a fork to a project, its
  developer's machine and its CI, with a node table.
- 7.2: upstream or a fork as the source, and moving from one to the other.
- 7.3: submodule, clone, copy or hooks only, each pinned to a tag.
- 7.4: the team moves the pin; a fork may add an updater, bound by three
  rules from FR-08-04 and FR-09-03.
- spec.md links the chapter instead of "Not applicable".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH
…r 7's diagram (#2410)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH
…apter 7's diagram (#2410)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH
… CI (#2410)

The local hook gives early feedback; CI is the gate every change passes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH
…lly (#2410)

- 4.2 Delivery model; 6.1-6.5 Context generation, Task skill loading,
  Hook execution in CI, Upstream synchronisation, Release adoption.
- Each diagram's title and alt text follow its section; chapter 7's
  diagram is the Deployment overview.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH
…hapter 7.3 (#2410)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH
…pin in the table (#2410)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH
… switch in 7.2 (#2410)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH
@braboj
braboj merged commit 9c6cc18 into main Oct 30, 2026
14 checks passed
@braboj
braboj deleted the docs/ch7-distribution branch October 30, 2026 07:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Write chapter 7 as the distribution view

1 participant