Architecture Decisions¶
ProActive ReSolutions Writing Studio — Governance Log
Source: _architecture/GOVERNANCE_LOG.md
Last updated: March 2026
This page summarizes the architectural decisions that have shaped the Writing Studio. Full rationale and affected artifacts are in the Governance Log. Each decision is permanent record — once made, decisions are not deleted, only superseded.
Decisions Summary¶
| ID | Date | Type | Decision |
|---|---|---|---|
| GOV-001 | March 2026 | Architecture | Platform instantiated. Seven-layer architecture, four-mode HITL, WSD schema adopted. |
| GOV-002 | March 2026 | Scope | Build sequence re-ordered: practitioner content first, academic track parallel. |
| GOV-003 | March 2026 | Pattern/Process | Publisher Disclosure Matrix updated. Slash commands expanded. Stage 5.5 Atomization added. |
| GOV-004 | March 2026 | Pattern | PATTERN-TRADE-ARTICLE-v1 created. Seven-stage trade article pattern. |
| GOV-005 | March 2026 | Process | Continuous Excellence Protocol infrastructure created. Component Registry and Signal Log initialized. |
| GOV-006 | March 2026 | Architecture | Voice profile system redesigned. Multi-tier architecture. Discourse Ground concept. |
| GOV-007 | March 2026 | Pattern | Stage 3 review protocol extended (R10 Originality, R11 Craft reviewers). Multiple pattern enrichments. |
| GOV-008 | March 2026 | Architecture | Cascade system architecture adopted. Four levels, five feedback loops, fifteen artifacts. |
| GOV-009 | March 2026 | Process | Distribution Brief created before production begins. |
| GOV-010 | March 2026 | Architecture | Single Source of Truth implementation pattern established. |
| GOV-011 | March 2026 | Architecture | Audience Persona methodology standardized: VPC + JTBD + Discourse Ground. |
| GOV-012 | March 2026 | Architecture | Artifact metadata headers standardized (YAML frontmatter). |
| GOV-013 | March 2026 | Architecture | Multi-signal artifact monitoring automation deployed. |
| GOV-014 | March 2026 | Architecture/Scope | Docs site extended with 6th map and Project Management section. |
| GOV-015 | March 2026 | Process | Three protocol gaps identified and logged. Two resolved. |
Full Decision Records¶
GOV-001 — March 2026 — Architecture¶
Decision: Platform instantiated. Seven-layer architecture adopted. Four-mode HITL model adopted. WSD schema adopted (revised structure per Research Findings v1.0, placing Locked Commitments at top and Session Brief at bottom).
Rationale: Initial platform design based on broad research sweep and targeted thread research.
Initiated by: Design session, March 2026.
GOV-002 — 9 March 2026 — Scope / Architecture¶
Decision: Build sequence re-ordered. Practitioner/thought leadership content production (Phase 1A) takes priority over academic patterns (Phase 1B). Professional Voice Profile (Section B) built before Scholarly Voice (Section A).
Rationale: ProActive ReSolutions' immediate business need is Canadian brand re-establishment and sales growth. Re-sequencing puts first published content within 2 weeks while preserving the academic track on a parallel timeline.
Initiated by: Strategic alignment session with Richard, 9 March 2026.
GOV-003 — 10 March 2026 — Pattern / Process / Scope¶
Decision: Three platform enhancements: (1) Publisher Disclosure Matrix updated with 6 material changes. (2) Slash command suite expanded from 6 to 9. (3) Stage 5.5 (Atomization & Distribution) added to PATTERN-PRACTITIONER-ARTICLE-v1 — hub-and-spoke model producing LinkedIn posts, executive summary, and framework visual spec from each piece.
Rationale: Extracted from publication-institutional-listening project infrastructure. Stage 5.5 addresses the gap between publication and distribution.
Initiated by: Handoff from publication-institutional-listening extraction analysis, 10 March 2026.
GOV-004 — 11 March 2026 — Pattern¶
Decision: PATTERN-TRADE-ARTICLE-v1 created. Mid-weight pattern for trade/industry publication articles (1,500–3,000 words) with light sourcing requirements (5–12 references). Seven stages total.
Rationale: GOV-002 identified PATTERN-TRADE-ARTICLE as a priority build. Trade publications occupy a distinct niche between blog and academic patterns.
Initiated by: Platform build session, 11 March 2026.
GOV-005 — 11 March 2026 — Process / Architecture¶
Decision: Continuous Excellence Protocol (PATT-024) infrastructure created. Component Registry (_architecture/component-registry.yaml) and Signal Log (_architecture/signal-log.yaml) initialized. 41 artifacts inventoried. First biweekly review scheduled for 2026-03-25. CLAUDE.md committed to the repository.
Rationale: DEC-228 adopted PATT-024 for the Writing Studio as its founding adopter.
Initiated by: Platform build session, 11 March 2026.
GOV-006 — 12 March 2026 — Architecture / Knowledge Base¶
Decision: Voice profile system redesigned. Multi-tier architecture: schema layer, speaker-first directory hierarchy, persistent voice-profile.md per speaker, context-guides, calibration-log.yaml. Key concept: Discourse Ground — the prior and enabling context of any communication.
Rationale: Original single-file voice profile had no listener dimension, no multi-speaker support, and no calibration mechanism. External research (NN/G Four Dimensions, ghostwriting methodology) validated the redesign.
Initiated by: Design critique session with Richard, 12 March 2026.
GOV-007 — 13 March 2026 — Pattern / Architecture / Process¶
Decision: Stage 3 review protocol extended. R10 (Originality/Positioning Reviewer) and R11 (Prose/Craft Editor) added. Multiple pattern enrichments. Bidirectional revision rules added to both PRACTITIONER and TRADE patterns.
Rationale: External review of burnout article v2 identified echo risk — a Stage 1 design failure with a Stage 3 detection gap. Both gaps closed.
Initiated by: Burnout article v2 external review session, 13 March 2026.
GOV-008 — 24 March 2026 — Architecture¶
Decision: Cascade system architecture adopted. Four-level hierarchy: Level 1 Per-Piece, Level 2 Sector/Audience Intelligence, Level 3 Quarterly Planning, Level 4 Annual Strategic. Five named feedback loops. Three-tier metrics framework (Tier 1 Reach, Tier 2 Engagement/EQS, Tier 3 Business Impact). Fifteen new artifacts created.
Rationale: Maps analysis identified the Studio as "step 4 of 11 in the content value chain" with missing downstream infrastructure. Cascade architecture fills the gaps downstream of production.
Initiated by: Strategic buildout session, 24 March 2026.
GOV-009 — 24 March 2026 — Process¶
Decision: Distribution Brief created before production begins. The cascade plan is locked before any drafting starts. Prevents the "dead-end publication pattern."
Rationale: Content Strategy Distribution Plan established the pattern. GOV-008 formalized it as a per-project artifact.
Initiated by: Cascade build session, 24 March 2026.
GOV-010 — 24 March 2026 — Architecture¶
Decision: Single Source of Truth (SSOT) implementation pattern established. EQS formula canonical in PERFORMANCE_TRACKER.md. Audience hierarchy canonical in BUSINESS_STRATEGY_BRIEF.md. All other artifacts reference, never redefine. Metadata headers declare ownership.
Rationale: SSOT violations created in the same session that introduced the principle. "Every manual process becomes a source of drift in a small team."
Initiated by: Cascade build session, 24 March 2026.
GOV-011 — 24 March 2026 — Architecture¶
Decision: Audience Persona methodology standardized: VPC + JTBD + Discourse Ground. Standard sections across all persona files.
Rationale: Healthcare HR Director persona (GOV-007) established VPC + JTBD as the pattern. Standardizing ensures all personas are consistent and directly usable for content calibration.
Initiated by: Cascade build session, 24 March 2026.
GOV-012 — 24 March 2026 — Architecture / Process¶
Decision: Artifact metadata headers standardized. All artifacts carry YAML frontmatter: artifact_id, owns, references, feeds, map_component, owner, last_updated. Machine-readable by artifact monitor.
Rationale: Without metadata headers, the inter-artifact relationship graph exists only in the architecture document. Metadata headers make the system self-documenting.
Initiated by: Cascade build session, 24 March 2026.
GOV-013 — 24 March 2026 — Architecture / Process¶
Decision: Multi-signal artifact monitoring automation deployed. Monitors: artifact count (WARN >25, CRIT >40), SSOT violations, broken cross-references, incomplete project artifact sets. Post-commit hook runs silently; fires on threshold breach. Notification via ~/bin/notify.sh.
Rationale: Single-metric count threshold is arbitrary and gameable. "Automation-first principle: never rely on humans to remember, monitor, or execute routine checks." Multi-signal monitoring is more robust.
Initiated by: Cascade build session, 24 March 2026.
GOV-014 — 24 March 2026 — Architecture / Scope¶
Decision: Docs site extended with 6th HTML map (Cascade System Architecture) and Project Management section (artifact inventory, active pipeline, architecture decisions). Non-technical stakeholders are the primary audience for the docs site.
Rationale: 15 new artifacts and the cascade architecture were added without updating the docs site. A "new architecture → new map" rule prevents documentation debt accumulation.
Initiated by: Cascade build session, 24 March 2026.
GOV-015 — 24 March 2026 — Process / Architecture¶
Decision: Three protocol gaps identified and logged. Two resolved in-session:
- Visual artifact pre-production checklist — OPEN. No checklist exists for visual artifacts. Required items: map type, tool fitness, quality criteria, governance alignment. To be added to AGENTS.md or
_architecture/VISUAL_PRODUCTION_PROTOCOL.md. - ARTIFACT_FLOW_MAP staleness — RESOLVED. Two MISSING entries corrected. Root cause: no map update trigger when studio artifacts are created.
- AGENTS.md build state maintenance — RESOLVED. Stale "NOT YET BUILT" entry corrected. Root cause: no update reminder on major artifact creation/retirement.
Initiated by: Studio runthrough session, 24 March 2026.
For the full governance log including affected artifacts and detailed rationale: _architecture/GOVERNANCE_LOG.md