Handbook

How to roll out Blueprints in one engineering team

Rolling out Blueprints when one squad needs shared vocabulary — lightest formality.

What it is

Rolling out Blueprints when one squad needs shared vocabulary — lightest formality.

Parent page: Team rollout patterns.

Adopting Blueprints path B or C is a rough match, but only one team is in scope first.

At least one repo has blueprints/, project sdlc/, and optionally forge/ (Project setup checklist).

Aspect	Guidance
Anchor repo	Pick one service or library repo as the reference; document its layout in your internal wiki. Others copy the same submodule pin and scripts.
Read order	Software delivery overview for lifecycle language; avoid assigning the whole blueprint tree as homework.

Role	Owns
Tech lead	Anchor repo layout and first Project setup checklist verify pass for that repo
Maintainer	Submodule pointer when the approved upstream commit moves
Product / EM	Which methodology slice the team standardizes on first (not “everything at once”)

Week	Focus	Success signal
0	Choose anchor repo; document its layout internally	New teammates can name baseline (`blueprints/`) vs project (`sdlc/`, `docs/`)
1–2	Each developer runs the same verify steps	No one-off edits inside `blueprints/` for product wording
3–4	One shared read order (e.g. Software delivery overview sections by role)	Onboarding links to sections, not the whole tree

Risk	Mitigation
Homework overload	Cap reading to one slice; use Adopting Blueprints to justify the scope
Drift in ceremonies	Tie rituals to the anchor repo’s documented layout

Anti-pattern	Better
Forking upstream `blueprints/` for one team’s wording	Use project `sdlc/` and Blueprint policy
“Everyone read everything”	Publish a short read order and revisit in retro


Starting situation	One squad owns a single API; path B adoption is chosen; other teams are out of scope for now.
Action taken	Tech lead documents the anchor repo layout; others clone the same submodule pin and run Project setup checklist verify steps.
Expected result	Two repos match the same baseline without custom forks of `blueprints/sdlc/`.
What to check	Onboarding doc links to Software delivery overview sections by role, not the whole tree.


Starting situation	A platform library repo is the natural anchor; app teams will follow in a later wave.
Action taken	Library team completes verify steps and documents the submodule pin; app teams are told to copy the same ritual when they join.
Expected result	One golden pattern exists before scaling to more repos.
What to check	Updating the Blueprints submodule is linked from the team wiki or runbook.

One anchor repo is documented; teammates can repeat Project setup checklist verify steps without one-off forks.