docs(0.2): multi-repo alignment example fixture (Track 6.4)#152
Open
docs(0.2): multi-repo alignment example fixture (Track 6.4)#152
Conversation
Adds the canonical 3-repo convergence example for the Align pillar: docs/examples/align/multirepo/. Companion to the Track 6.1 manifest format (in PR #148) and the alignment-first migration framing (also #148). The example walks through Acme Corp's three Node services on partially-divergent test stacks, declaring a portfolio manifest, and the convergence sequence the cross-repo aggregator will recommend when it lands in 0.2.x. Until the aggregator binary ships, the example is illustrative — the README documents the *shape* of the expected output so: - the contract is locked before the implementation chases it - adopters who hand-write a repos.yaml today learn the file format that 0.2.x will consume unchanged - the alignment-first vs health-first sequencing rule is documented as the contract, not a runtime detail Files: - README.md full convergence story + expected output shape - .terrain/repos.yaml runnable manifest matching the story - snapshots/README.md notes on snapshotPath: future expansion Status posture matches the parity plan: Track 6 is parallel and partial-ship-OK in 0.2.0; Align is the secondary pillar; multi- repo is explicitly Tier 3 / experimental until 0.2.x ships the aggregator. This example is the bridge that locks the contract between today's manifest format and tomorrow's binary output. Verification: make docs-verify clean. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
[INFO] Terrain — Informational only
Limitations
Generated by Terrain · Targeted Test ResultsNo tests selected — change affects only non-code files. |
Terrain AI Risk Review
Decision: PASS — AI surfaces are covered. |
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
Adds the canonical 3-repo convergence example for the Align pillar:
docs/examples/align/multirepo/. Companion to the Track 6.1manifest format (PR #148) and the alignment-first migration framing.
The example documents the contract Acme Corp would see using the
multi-repo manifest + aggregator: declare three services, see
drift from the framework of record, get an alignment-first
recommended convergence sequence.
Why illustrative, not runnable
The cross-repo aggregator is Track 6.2/6.3 (0.2.x work). The
manifest format ships in 0.2.0 (PR #148). This example is the
bridge: the README documents the shape of expected output so:
repos.yamltoday learn the fileformat 0.2.x will consume unchanged
documented up front, not a runtime detail
Files
docs/examples/align/multirepo/README.md— full convergencestory + expected aggregator output
docs/examples/align/multirepo/.terrain/repos.yaml— runnablemanifest matching the story
docs/examples/align/multirepo/snapshots/README.md— noteson the snapshotPath: future-expansion path
Test plan
make docs-verifycleango test ./internal/portfolio/...cleanPlan tracker
Closes Track 6.4. Track 6 remaining: 6.2 + 6.3 (cross-repo
aggregator) + 6.7 (conversion-corpus calibration to A-grade) —
all 0.2.x work per the partial-ship-OK posture.
🤖 Generated with Claude Code