# thercha/bone-and-bloom-agency-os architecture

> Architecture diagram of the GitHub repository thercha/bone-and-bloom-agency-os, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-08-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thercha/bone-and-bloom-agency-os
- Repository: https://github.com/thercha/bone-and-bloom-agency-os

## Overview

#### Purpose and Entry Points
This repository is the canonical, versioned operating system for Bone & Bloom advertising commercialisation—not an application runtime. It defines how a completed product moves through a repeatable campaign lifecycle. Start operational work with `AGENCY_DNA_PACK.md`, the assigned manual in `roles/`, the authority mapping in `DECISION_MATRIX.md`, then the task SOP in `sops/` and its referenced template in `templates/`.

#### Governance and Change Control
The operating model is constrained by product requirements, constitutional rules, standards, and architecture decisions. `PRODUCT_REQUIREMENTS_DOCUMENT.md`, `OPERATING_MODEL.md`, and `SYSTEM_BLUEPRINT.md` define the top-level system; `PROJECT_CHARTER.md` governs contributions. Structural changes require ADRs under `adr/`, while release sequencing and implementation work flow through `BUILD_QUEUE.md` and `RELEASE.md`. The Founder owns constitutional/major direction; the Lead Systems Architect owns structure and release sequencing; the Lead Engineer maintains repository integrity.

#### Authority and Capability Model
Work is assigned through role ownership and decision rights rather than ad hoc collaboration. `ORGANISATION_CHART.md`, `DECISION_MATRIX.md`, and role manuals such as `roles/ROLE-Operations-Manager.md` establish responsibility and approval boundaries. Capability manuals in `capabilities/` define the agency’s functional domains—strategy, research, creative, copy, analytics, media buying, operations, brand, and organisational memory—independent of specific tools or platforms.

#### Campaign Execution Pipeline
A campaign instance is initialized from `execution/CAMPAIGN-SKELETON/`, with stage-specific artifacts separated into intake, research, strategy, creative, copy, media, reviews, reports, and tests. The primary control flow is encoded by `sops/SOP-01-Product-Intake.md` through launch in `sops/SOP-09-Meta-Campaign.md`: intake → product understanding → audience research → strategy → creative/copy/production → quality review → campaign launch. Each handoff is intended to have an owner, template, and approver.

#### Measurement, Learning, and Reuse
After launch, performance operations form the feedback loop: reporting, optimisation, scaling, creative testing, retrospective learning, organisational memory, and archive. Key process contracts are `sops/SOP-13-Reporting.md`, `sops/SOP-14-Optimisation.md`, `sops/SOP-16-Scaling.md`, `sops/SOP-17-Creative-Testing.md`, `sops/SOP-10-Organisational-Memory.md`, and `sops/SOP-18-Archive.md`. Validated findings are persisted under `memory/`—including `memory/insights/`, `memory/audience-insights/`, `memory/creative-patterns/`, and `memory/benchmarks/`—so subsequent campaigns inherit evidence rather than recreate it.

#### Artifact Contracts, Runtime, and External Boundary
Templates are the output contracts joining SOP stages, roles, and campaign directories; examples include `templates/TEMPLATE-Strategy-Brief.md`, `templates/TEMPLATE-Creative-Brief.md`, `templates/TEMPLATE-Media-Plan.md`, and `templates/TEMPLATE-Performance-Report.md`. The material runtime is a documentation repository under version control, with GitHub Issues/Projects/PRs explicitly part of Lead Engineer execution. Meta is the named campaign-launch platform via `sops/SOP-09-Meta-Campaign.md`; no executable service, database, or application infrastructure is represented. Client-specific work is bounded under `clients/bone-and-bloom/`, while the OS excludes product creation, manufacturing, finance, HR, legal, and customer support.

Main entry points: [`sops/SOP-13-Reporting.md`](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-13-Reporting.md) (Performance Operations), [`sops/SOP-01-Product-Intake.md`](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-01-Product-Intake.md) (Intake & Research), [`BUILD_QUEUE.md`](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/BUILD_QUEUE.md) (Build & Release Control), [`templates/TEMPLATE-Strategy-Brief.md`](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/templates/TEMPLATE-Strategy-Brief.md) (Strategy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_governance["Governance"]
  node_system_definition["System Definition<br/>operating model<br/>[OPERATING_MODEL.md]"]
  node_product_requirements["Product Requirements"]
  node_system_blueprint["System Blueprint<br/>architecture"]
  node_contribution_governance["Contribution Governance<br/>charter<br/>[PROJECT_CHARTER.md]"]
  node_adrs["Architecture Decisions<br/>ADR register"]
  node_release_control["Build &amp; Release Control<br/>delivery planning<br/>[BUILD_QUEUE.md]"]
end

subgraph group_operating_model["Operating Contracts"]
  node_agency_dna["Agency DNA Pack<br/>operational entry point<br/>[AGENCY_DNA_PACK.md]"]
  node_authority_model["Authority Model<br/>decision rights<br/>[DECISION_MATRIX.md]"]
  node_role_manuals["Role Manuals<br/>responsibility manuals"]
  node_capability_manuals["Capability Manuals<br/>functional domains"]
  node_sops["SOP Library<br/>process contracts"]
  node_templates["Template Library<br/>artifact contracts"]
end

subgraph group_campaign["Campaign Lifecycle"]
  node_campaign_skeleton["Campaign Skeleton<br/>campaign workspace"]
  node_intake_research["Intake &amp; Research<br/>campaign stages"]
  node_strategy["Strategy<br/>campaign stage"]
  node_creative_copy_production["Creative, Copy &amp; Production<br/>campaign stages"]
  node_review_launch{{"Review &amp; Meta Launch<br/>campaign release"}}
  node_client_boundary["Bone &amp; Bloom Client Space<br/>client boundary"]
end

subgraph group_learning["Learning Loop"]
  node_performance_operations["Performance Operations<br/>measurement loop"]
  node_organisational_memory[("Organisational Memory<br/>validated evidence")]
  node_archive["Campaign Archive<br/>retention process<br/>[SOP-18-Archive.md]"]
end

node_product_requirements -->|"constrains"| node_system_definition
node_system_blueprint -->|"architects"| node_system_definition
node_contribution_governance -->|"requires"| node_adrs
node_adrs -->|"feeds approved changes to"| node_release_control
node_agency_dna -->|"orients work in"| node_role_manuals
node_authority_model -->|"assigns decision rights to"| node_role_manuals
node_capability_manuals -->|"inform"| node_sops
node_role_manuals -->|"own execution of"| node_sops
node_sops -->|"specify outputs with"| node_templates
node_templates -->|"populate"| node_campaign_skeleton
node_client_boundary -->|"contains instances of"| node_campaign_skeleton
node_campaign_skeleton -->|"starts"| node_intake_research
node_intake_research -->|"evidence informs"| node_strategy
node_strategy -->|"briefs"| node_creative_copy_production
node_creative_copy_production -->|"submits for review and"| node_review_launch
node_review_launch -->|"live campaign measured by"| node_performance_operations
node_performance_operations -->|"validates and stores findings in"| node_organisational_memory
node_organisational_memory -.->|"evidence reused by"| node_intake_research
node_performance_operations -->|"closes into"| node_archive
node_release_control -.->|"sequences repository delivery of"| node_sops

click node_system_definition "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/OPERATING_MODEL.md"
click node_product_requirements "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/PRODUCT_REQUIREMENTS_DOCUMENT.md"
click node_system_blueprint "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/SYSTEM_BLUEPRINT.md"
click node_contribution_governance "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/PROJECT_CHARTER.md"
click node_release_control "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/BUILD_QUEUE.md"
click node_agency_dna "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/AGENCY_DNA_PACK.md"
click node_authority_model "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/DECISION_MATRIX.md"
click node_intake_research "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-01-Product-Intake.md"
click node_strategy "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/templates/TEMPLATE-Strategy-Brief.md"
click node_creative_copy_production "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/templates/TEMPLATE-Creative-Brief.md"
click node_review_launch "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-09-Meta-Campaign.md"
click node_performance_operations "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-13-Reporting.md"
click node_archive "https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-18-Archive.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_system_definition,node_product_requirements,node_system_blueprint,node_contribution_governance,node_adrs,node_release_control toneBlue
class node_agency_dna,node_authority_model,node_role_manuals,node_capability_manuals,node_sops,node_templates toneAmber
class node_campaign_skeleton,node_intake_research,node_strategy,node_creative_copy_production,node_review_launch,node_client_boundary toneMint
class node_performance_operations,node_organisational_memory,node_archive toneRose
```

## Components

### Governance

System authority and controlled change.

- [System Definition](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/OPERATING_MODEL.md): operating model · Defines the commercialisation OS and its constraints. · `OPERATING_MODEL.md`
- [Product Requirements](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/PRODUCT_REQUIREMENTS_DOCUMENT.md): requirements · `PRODUCT_REQUIREMENTS_DOCUMENT.md`
- [System Blueprint](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/SYSTEM_BLUEPRINT.md): architecture · `SYSTEM_BLUEPRINT.md`
- [Contribution Governance](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/PROJECT_CHARTER.md): charter · Controls repository contributions and major change. · `PROJECT_CHARTER.md`
- **Architecture Decisions**: ADR register · Required for structural changes.
- [Build & Release Control](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/BUILD_QUEUE.md): delivery planning · Sequences implementation and releases. · `BUILD_QUEUE.md`

### Operating Contracts

Reusable responsibilities and process contracts.

- [Agency DNA Pack](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/AGENCY_DNA_PACK.md): operational entry point · Starting context for operational work. · `AGENCY_DNA_PACK.md`
- [Authority Model](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/DECISION_MATRIX.md): decision rights · Maps ownership and approval boundaries. · `DECISION_MATRIX.md`
- **Role Manuals**: responsibility manuals · Assign execution ownership by role.
- **Capability Manuals**: functional domains · Defines cross-tool agency capabilities.
- **SOP Library**: process contracts · Defines stage handoffs, owners, approvals, and procedures.
- **Template Library**: artifact contracts · Standard outputs consumed by campaign stages.

### Campaign Lifecycle

Client work progresses through controlled stages.

- **Campaign Skeleton**: campaign workspace · Initializes stage-separated campaign artifacts.
- [Intake & Research](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-01-Product-Intake.md): campaign stages · Captures product context and audience evidence. · `sops/SOP-01-Product-Intake.md`
- [Strategy](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/templates/TEMPLATE-Strategy-Brief.md): campaign stage · Converts research into campaign direction. · `templates/TEMPLATE-Strategy-Brief.md`
- [Creative, Copy & Production](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/templates/TEMPLATE-Creative-Brief.md): campaign stages · Produces campaign assets from approved briefs. · `templates/TEMPLATE-Creative-Brief.md`
- [Review & Meta Launch](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-09-Meta-Campaign.md): campaign release · Quality-gates and launches the campaign on Meta. · `sops/SOP-09-Meta-Campaign.md`
- **Bone & Bloom Client Space**: client boundary · Bounds client-specific work within the OS.

### Learning Loop

Performance evidence is retained for reuse.

- [Performance Operations](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-13-Reporting.md): measurement loop · Reports, optimises, scales, and tests live campaigns. · `sops/SOP-13-Reporting.md`
- **Organisational Memory**: validated evidence · Persists reusable campaign findings.
- [Campaign Archive](https://github.com/thercha/bone-and-bloom-agency-os/blob/main/sops/SOP-18-Archive.md): retention process · Closes and preserves completed campaign records. · `sops/SOP-18-Archive.md`

## Connections

- Product Requirements → System Definition: constrains
- System Blueprint → System Definition: architects
- Contribution Governance → Architecture Decisions: requires
- Architecture Decisions → Build & Release Control: feeds approved changes to
- Agency DNA Pack → Role Manuals: orients work in
- Authority Model → Role Manuals: assigns decision rights to
- Capability Manuals → SOP Library: inform
- Role Manuals → SOP Library: own execution of
- SOP Library → Template Library: specify outputs with
- Template Library → Campaign Skeleton: populate
- Bone & Bloom Client Space → Campaign Skeleton: contains instances of
- Campaign Skeleton → Intake & Research: starts
- Intake & Research → Strategy: evidence informs
- Strategy → Creative, Copy & Production: briefs
- Creative, Copy & Production → Review & Meta Launch: submits for review and
- Review & Meta Launch → Performance Operations: live campaign measured by
- Performance Operations → Organisational Memory: validates and stores findings in
- Organisational Memory → Intake & Research: evidence reused by
- Performance Operations → Campaign Archive: closes into
- Build & Release Control → SOP Library: sequences repository delivery of