Topic: architecture board charter template

Architecture Board Charter Template — Scope, Cadence, Decision Rights, and the Governance Log Boundary

An Architecture Board's charter is the single document that determines whether the forum becomes a useful precedent-setting venue or a quarterly bottleneck nobody routes through. Most charters fail in predictable ways: they over-specify scope, under-specify decision rights, and leave the relationship to the per-team ADR practice ambiguous. This page documents what a working charter actually contains — the seven required sections, the eight standing roles, the explicit ADR-vs-Board-decision boundary, the decision-rights matrix that prevents bottlenecks, and the failure modes that kill these forums.

TL;DR

A working Architecture Board charter ships seven sections: (1) purpose and scope (what the Board reviews, what it doesn't), (2) standing roles (eight roles — five voting, three non-voting), (3) cadence (monthly meeting plus async review queue), (4) decision rights (three classes: advisory, approval, escalated), (5) input gates (what must be true before an ADR reaches the Board agenda), (6) output artifacts (Board minutes, Governance Log entry, ADR status update), and (7) review and retrospective (quarterly self-assessment with bias toward "are we approving too much" not "are we missing things"). The Board is NOT a replacement for the ADR practice — most ADRs never reach it. The boundary: per-team ADRs go in /doc/decisions/; the small subset that crosses teams or sets new precedent additionally lands in the TOGAF Governance Log with a Board-minutes link. The single biggest failure mode is scope creep — start with three approval categories, not ten. Below 50 engineers an Architecture Board usually doesn't earn its cost; the meeting becomes the same three people approving decisions they'd have made anyway.

When you actually need an Architecture Board

Architecture Boards are an enterprise-shaped pattern. Adopting one prematurely (below ~50 engineers, or fewer than three independently-staffed product teams) is one of the most common architecture-process mistakes: the meeting becomes a tax on the same three senior engineers who would have made the decisions anyway, and the resulting Governance Log entries describe pre-determined outcomes rather than real precedent.

The signals that you actually need one:

The signals that you do NOT need one:

The seven sections of a working charter

Every section below has a "what to write" and a "what to avoid" pairing — the avoid column is where most charters go wrong.

SectionWhat to writeWhat to avoid
1. Purpose & scope Two-paragraph statement of what the Board reviews (cross-team architecture decisions, new pattern promotion, audit-relevant decisions) and an explicit list of what it does NOT review (per-team architecture, code-level pattern choices, tactical in-flight changes). "The Board reviews all architecture decisions" — guaranteed bottleneck inside six months.
2. Standing roles Eight roles: Chair, two Senior Architects, one Security representative, one Data representative (voting), plus Engineering Manager rotation, Product representative, and Compliance representative (non-voting). Quorum = 3 of 5 voting. Single-CTO Board (no quorum), or open-ended "anyone can attend and vote" (no clear authority).
3. Cadence Monthly synchronous meeting (60-90 min, fixed second Tuesday or similar) PLUS async review queue with 5-business-day SLA for decisions that don't need synchronous discussion. Weekly meetings (over-cadence; engineers route around it). Quarterly only (under-cadence; decisions stall waiting for the meeting).
4. Decision rights Three classes per category: advisory (Board reviews, team decides), approval (Board vote binding), escalated (Board hears, escalates above). 3-5 categories named for approval; everything else advisory. Everything advisory (rubber stamp). Everything approval (bottleneck). Unspecified ("Board reviews and feedback is incorporated") — guarantees ambiguity in the room.
5. Input gates An ADR can reach the Board agenda only if: (a) ADR draft exists in /doc/decisions/, (b) two named consulted parties from affected teams have reviewed, (c) Context section identifies the cross-team boundaries touched. Submitted via PR labeled arch-board. Verbal-only proposals. ADRs without identified consulted parties. Decisions where the Board is the first reviewer (means the team didn't do its homework).
6. Output artifacts Three artifacts per Board-reviewed decision: (a) Board minute appended to /governance/board-minutes/YYYY-MM-DD.md with attendance, decision class, vote, and a one-paragraph rationale; (b) Governance Log entry at /governance/log/<adr-id>.md linking the ADR file and the minute; (c) ADR Status field updated to Accepted (or Trial-Period) with the governance_review_id frontmatter field set. "Decision is recorded" without specifying where. Verbal rationale (loses to memory inside three months).
7. Review & retro Quarterly self-assessment asking "are we approving things that didn't need approval" — measure by counting decisions ratified without substantive discussion (the rubber-stamp signal). Charter amended via PR with full Board majority. Annual review. "Are we missing things" framing — the asymmetry is intentional, the cost of bottlenecking is much higher than the cost of a missed review.

The eight standing roles

Five voting + three non-voting is the working composition for a fifty-to-two-hundred-engineer organization. Larger organizations sometimes split into multiple domain-specific boards (a Data Board, a Platform Board) federated under an Enterprise Architecture Board; the role taxonomy below scales as the per-board membership rather than expanding the Board itself.

Quorum is 3 of 5 voting members for routine decisions; 4 of 5 for charter amendments and approval-class votes that cross domain boundaries (e.g. a decision touching both security and data needs Security + Data + at least two of Chair/Architects). Sub-quorum meetings can produce advisory output but cannot ratify approval-class decisions.

The decision-rights matrix

The single most important section of the charter. A working matrix names 8-12 categories with explicit class assignments. Below is a template that's worked across multiple SaaS organizations — start from this and adjust per your domain.

Decision categoryClassRationale
New cross-team API contractApprovalAffects multiple teams' implementation and SLAs; precedent matters for future contracts.
New shared library / pattern adoptionApprovalPromotes a per-team implementation to org-wide; the Board's authorization is the promotion event.
Choice of new datastore or cacheApprovalOperational long tail — a team picks Redis, the platform team operates it for years. Cross-team consequences.
PII handling boundary changesApprovalCompliance + security implications. Always Approval regardless of team scope.
Auth model changesApprovalCross-team contract by definition; security-critical.
Per-team service architecture (within an existing pattern)AdvisoryTeam owns the decision; Board's job is precedent-aware feedback, not approval.
Per-team library/framework version upgradesAdvisoryTactical; team owns it.
Per-team operational tooling choicesAdvisoryLocal concern unless it touches shared infrastructure.
Code-level pattern conventionsOut of scopeBelongs in team's engineering handbook, not the Board.
Acquisition-driven integration architectureEscalatedAbove Board authority — CTO/CIO calls the integration shape; Board hears for context only.
Multi-million-dollar vendor contractsEscalatedProcurement authority sits above the Board.
Disaster-recovery posture changesApprovalCross-team; audit-relevant; rare enough that Approval doesn't bottleneck.

Two patterns to recognize. Most categories are Advisory. A working Board has roughly 3-5 categories at Approval, 6-8 at Advisory, 1-2 at Escalated, and an explicit "out of scope" list. If your matrix has more than 6 Approval categories, the Board will become a bottleneck within six months. The split between Advisory and Approval is "does this affect another team or set new precedent." Per-team architectural choices get Advisory; cross-team contracts and pattern promotion get Approval. This is the boundary the charter exists to enforce.

Worked charter — one-page version

A real, copy-paste-and-adjust charter for a 75-engineer SaaS. Three to five paragraphs total — long charters die in PR review. Names are placeholders.

# Architecture Board Charter — Acme Inc.
# v1, ratified 2026-01-15

## Purpose & Scope
The Architecture Board exists to review architecture decisions that affect multiple
teams, set new precedent, or carry audit-defensibility implications. The Board does
NOT review per-team architectural choices that fit existing patterns, code-level
convention questions, or tactical in-flight changes.

## Standing Roles (5 voting / 3 non-voting)
Chair: Sara L. (rotates 2027-01-15). Senior Architects: Jin H. (Platform), Marco V.
(Product). Security: Priya R. Data: Tomás G. Non-voting rotation: EM (quarterly),
Product (Lila K.), Compliance (Kim S.). Quorum: 3 of 5 voting (4 of 5 for charter
amendments and cross-domain Approval decisions).

## Cadence
Monthly synchronous meeting, second Tuesday 14:00-15:30 UTC. Async review queue with
5-business-day SLA via #arch-board Slack and PRs labeled `arch-board`.

## Decision Rights
- Approval (binding): cross-team API contracts, shared library promotion, new datastore
  or cache adoption, PII handling boundary changes, auth model changes, DR posture.
- Advisory (review only): per-team service architecture, library upgrades, operational
  tooling.
- Escalated to CTO: acquisition integration shape, vendor contracts >$500k.
- Out of scope: code-level convention, in-flight tactical changes.

## Input Gates
ADR drafted in /doc/decisions/, two consulted parties named from affected teams,
Context section identifies cross-team boundaries. PR labeled `arch-board` opens the
review window.

## Output Artifacts
(1) Board minute at /governance/board-minutes/YYYY-MM-DD.md (attendance + decision
class + vote + rationale). (2) Governance Log entry at /governance/log/<adr-id>.md
linking the ADR and the minute. (3) ADR Status updated to Accepted (or Trial-Period)
with governance_review_id frontmatter field set.

## Review & Retrospective
Quarterly self-assessment: count decisions ratified without substantive discussion
(rubber-stamp signal). Goal <20%. Charter amended via PR with 4-of-5 voting
majority.

Notice three things. It fits on one page. Charters that run to multiple pages either repeat themselves or hide ambiguity in volume. It names actual people. Charters with only role names (no names) signal that the Board hasn't started yet; ratification day is when names go in. The decision-rights section names categories, not principles. "Significant decisions require approval" is a non-charter; "cross-team API contracts require Approval" is the actual rule.

Input gates — what an ADR needs to reach the Board

The most common pre-meeting failure is an ADR that arrives at the Board agenda without enough preparation. Three gates eliminate ~80% of these.

  1. The ADR file exists. Drafted in /doc/decisions/<NNNN>-<slug>.md using the team's standard template (see ADR template for the body shape) before the Board meeting. Verbal-only proposals don't enter the queue. The ADR can be in Status: Proposed — the Board's job is to ratify (or reject, or trial-period) it.
  2. Two consulted parties are named. The proposing team has named two engineers from affected teams (or domains) who reviewed the proposal pre-Board and either supported it or filed objections in the PR. This catches the failure mode where the Board hears about cross-team conflicts in the room rather than ahead of time.
  3. Cross-team boundaries are explicit in the Context section. The ADR's Context section names which other teams' systems, contracts, or operational surfaces are touched. If the Context is purely local, the ADR shouldn't be at the Board (it's per-team and stays Advisory at most).

Boards that skip the input gates always end up with the Chair re-explaining the decision in the room while the actual technical review happens after the meeting in PR comments — wasting the synchronous slot. Inverting the order (PR review first, Board ratification second) is the working pattern.

The Governance Log boundary — ADR vs Board decision

The relationship to the per-team ADR practice is what most charters under-specify, and the source of most "is this an ADR or a Board decision" confusion.

The boundary is operational, not philosophical:

For organizations on TOGAF specifically, the Governance Log corresponds to the explicit Architecture Repository placement of the same name — see the TOGAF ADR template page for the three placements (Architecture Landscape, Reference Library, Governance Log) and the bar for promotion. Non-TOGAF organizations can use the Governance Log path simply as a flat directory under /governance/log/; the operational shape is identical.

Output artifacts — what the Board produces

Three deliverables per Board-reviewed decision. Without all three, the audit trail breaks.

  1. Board minute at /governance/board-minutes/YYYY-MM-DD.md. One file per Board meeting, aggregating all decisions reviewed in that meeting. Each decision section: title, ADR ID, decision class, vote tally (e.g. "Approval — 5/5 voting"), one-paragraph rationale capturing the substantive discussion. The rationale is the load-bearing artifact — votes alone don't survive memory.
  2. Governance Log entry at /governance/log/<adr-id>.md. One file per Board-reviewed decision, linking the ADR file and the minute that ratified it. Includes review_date, vote_class, vote_tally, and the link to the originating ADR's frontmatter governance_review_id.
  3. ADR Status update in the originating ADR file. Status moves from Proposed to Accepted (or Trial-Period, or back to Proposed with feedback, or Rejected) per the ADR status template. The governance_review_id frontmatter field is set to the Governance Log entry's filename, completing the bidirectional cross-link.

The reason for three artifacts (rather than one consolidated record) is failure-mode resilience. If the Board minute is lost (e.g. file system mishap, repository mistake), the Governance Log entry preserves the decision's existence. If the Governance Log directory is reorganized, the ADR's frontmatter still points back to the Board minute. The redundancy is intentional; an audit trail is only as good as its survival of operational accidents.

Four common failure modes

  1. Scope creep. The Board starts reviewing 3-5 decision categories and over six months drifts to reviewing every architectural decision because reviewing more feels like more work. Engineers route around the bottleneck either by skipping the practice entirely or by pre-deciding everything before the meeting (the meeting becomes ratification theater). Mitigation: the quarterly retrospective explicitly asks "are we approving things that didn't need approval" — not "are we missing things." The asymmetry is the point. The cost of approving an unnecessary decision is one rubber-stamp meeting; the cost of bottlenecking is months of decision latency. Charters that don't name this trade-off explicitly always drift toward over-review.
  2. Missing decision rights. The charter says "the Board reviews and provides feedback" without specifying whether that feedback is binding. The result is a Board where every decision's class is ambiguous in the room. Teams interpret feedback as advisory; the Board interprets it as approval. Six months later the first cross-team conflict surfaces and nobody can tell whether the Board's earlier review counted as authorization. Mitigation: the decision-rights matrix names categories explicitly and assigns one of three classes to each. No category is unspecified; "this case isn't in the matrix" is itself a Board agenda item to decide which class it belongs in.
  3. No quorum hygiene. The Board meets with two voting members present and ratifies decisions anyway because "we couldn't reach the others." Six months later an audit asks how a particular decision was approved and the minute shows two attendees voting where the charter requires three. Mitigation: sub-quorum meetings produce advisory output only; approval-class decisions defer to the next quorum-having meeting or use the async review queue with explicit voting.
  4. Personality of the Chair. A long-tenured Chair becomes the de facto Board policy — their preferences shape what gets approved and what doesn't, and the charter becomes irrelevant in practice because everyone reads the Chair instead of the matrix. Mitigation: annual Chair rotation, ratified in the charter. Short Chair tenures keep the matrix as the authoritative document. The same role-rotation pattern applies to the Senior Architect seats; rotating one of two annually keeps domain expertise stable while preventing single-person policy capture.

Three honest signals you've outgrown the Board

Architecture Boards should evolve as the organization scales. Three signals that the original charter no longer fits:

  1. Meeting volume is no longer feasible. The monthly meeting has 12+ ADRs queued and the Board can't substantively review more than 4-5 per session. The fix is either to split into domain-specific Boards (Data Board, Platform Board, Product Architecture Board) federated under an Enterprise Architecture Board, or to raise the input-gate bar so fewer ADRs reach the agenda.
  2. Cross-Board decisions are accumulating. A decision touches both Data and Platform domains and neither Board feels confident ratifying alone. This is the signal for an Enterprise Architecture Board layered above the domain-specific Boards. Don't bypass — federate.
  3. Compliance is asking for finer-grained evidence than minutes provide. SOC 2 Type 2 audits sometimes ask for per-decision evidence chains, including the Slack threads and PR comments leading to the Board ratification. The fix is a stricter Governance Log shape that captures the link graph (ADR + Slack archive link + PR link + Board minute) — not a different forum.

How WhyChose fits in

Most architecture decisions in fifty-to-two-hundred-engineer SaaS organizations are made in chat conversations between architects, engineering managers, and senior product engineers — days or weeks before the formal Board meeting that ratifies them. The Board minute documents the ratification. The actual reasoning happens earlier, in ChatGPT or Claude conversations where the trade-offs were explored and the decision converged. The WhyChose extractor reads chat exports and surfaces decision-shaped exchanges with the trade-offs considered at the time — including the alternatives sections that auditors test by asking "what else did you consider?" Drop the extracted record into /doc/decisions/, the team adds the cross-team Context, the input gates determine whether it reaches the Board agenda, and the Board's review process produces the formal ratification artifacts. The decision-archaeology question — "what conversation produced this ADR" — is answerable because the extracted record carries the original chat snippet as a backlink, even years later when the chat platform has rotated history. Pro tier exports to Notion / Linear / Obsidian; Team tier scopes the shared decision log by Project membership — useful for Boards whose members need access to the originating reasoning without each one running their own export.

Get early access

Related questions

Should the Board's minutes be public to all engineers, or restricted?

Default to public within the engineering organization (commit to /governance/board-minutes/ in the same repo as /doc/decisions/). Restriction is appropriate only for legally sensitive content (acquisition integration discussions, security-incident responses) which should be in a separate restricted repository or removed pre-publication. Wide visibility is the only way the Board's precedent actually informs subsequent decisions; restricted minutes recreate the silos the Board was supposed to break down.

How do you pick the first Chair?

The principal engineer or staff engineer with the most cross-team architectural context, NOT the CTO and NOT the most senior person available. CTO-as-Chair conflates Board authority with executive authority and turns every decision into an executive decision. The most senior person available is often someone whose context is local to one product — they don't have the cross-team visibility the Chair role requires. If no clear candidate exists, that's a signal you're not ready for a Board yet.

What's the relationship to the CTO's authority?

The CTO sits above the Board, not within it. Decisions in the Escalated class go from the Board to the CTO; the Board surfaces the trade-offs, the CTO decides. The CTO can also override Board decisions (any class) by calling the override explicit in writing — typically reserved for acquisition-driven integration choices or strategic redirections that the Board doesn't have full context for. Override use should be rare; if a CTO is overriding more than once or twice a year, the charter's decision-rights matrix needs to be amended to escalate that category natively.

Can the Board approve a decision before the ADR is fully written?

No — the input gates require the ADR file to exist in /doc/decisions/. The ADR can be in Status: Proposed and short on detail in some sections (Consequences in particular often gets refined after Board feedback), but the file has to exist. Approving verbal proposals breaks the bidirectional Governance Log link the audit trail depends on. If a decision is too urgent to wait for an ADR, it's a tactical decision and shouldn't be at the Board.

How does the Board interact with the ADR GitHub Action?

The ADR GitHub Action lints the per-team ADR practice (structure, numbering, supersession integrity) but doesn't enforce Board-specific rules. Add a small additional job to the workflow that verifies the governance_review_id frontmatter field is set on any ADR labeled arch-board after the corresponding Board meeting date — this catches ADRs that reached the Board but didn't get the bidirectional link to the Governance Log entry. The job is a 15-line bash + grep snippet; the per-team Action stays domain-agnostic.

Further reading