diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index adc3827..4e65376 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -1,8 +1,7 @@
 # Clone the repository
 
-git clone
-<https://github.com/hyperpolymath/InvestigativeJournalism.jl.git> cd
-InvestigativeJournalism.jl
+git clone https://github.com/hyperpolymath/InvestigativeJournalism.jl.git
+cd InvestigativeJournalism.jl
 
 # Using Guix (recommended for reproducibility)
 
@@ -10,41 +9,56 @@ guix develop
 
 # Or using toolbox/distrobox
 
-toolbox create InvestigativeJournalism.jl-dev toolbox enter
-InvestigativeJournalism.jl-dev \# Install dependencies manually
+toolbox create InvestigativeJournalism.jl-dev
+toolbox enter InvestigativeJournalism.jl-dev
+# Install dependencies manually
 
 # Verify setup
 
-just check \# or: cargo check / mix compile / etc. just test \# Run test
-suite
-
-
-    ### Repository Structure
-
-InvestigativeJournalism.jl/ ├── src/ \# Source code (Perimeter 1-2) ├──
-lib/ \# Library code (Perimeter 1-2) ├── extensions/ \# Extensions
-(Perimeter 2) ├── plugins/ \# Plugins (Perimeter 2) ├── tools/ \#
-Tooling (Perimeter 2) ├── docs/ \# Documentation (Perimeter 3) │ ├──
-architecture/ \# ADRs, specs (Perimeter 2) │ └── proposals/ \# RFCs
-(Perimeter 3) ├── examples/ \# Examples (Perimeter 3) ├── spec/ \# Spec
-tests (Perimeter 3) ├── tests/ \# Test suite (Perimeter 2-3) ├──
-.machine_readable/ \# ALL machine-readable content (Perimeter 1) │ ├──
-\*.a2ml \# State files (STATE, META, ECOSYSTEM, etc.) │ ├──
-bot_directives/ \# Bot configs │ └── contractiles/ \# Policy contracts
-(k9, dust, lust, must, trust) ├── .well-known/ \# Protocol files
-(Perimeter 1-3) ├── .github/ \# GitHub config (Perimeter 1) │ ├──
-ISSUE_TEMPLATE/ │ └── workflows/ ├── CHANGELOG.md ├── CODE_OF_CONDUCT.md
-├── CONTRIBUTING.md \# This file ├── GOVERNANCE.md ├── LICENSE ├──
-MAINTAINERS.md ├── README.adoc ├── SECURITY.md ├── flake.guix \# Guix
-flake — fallback (Perimeter 1) ├── guix.scm \# Guix package — primary
-(Perimeter 1) └── Justfile \# Task runner (Perimeter 1)
-
+just check   # or: cargo check / mix compile / etc.
+just test    # Run test suite
+
+### Repository Structure
+
+```text
+InvestigativeJournalism.jl/
+├── src/ # Source code (Perimeter 1-2)
+├── lib/ # Library code (Perimeter 1-2)
+├── extensions/ # Extensions (Perimeter 2)
+├── plugins/ # Plugins (Perimeter 2)
+├── tools/ # Tooling (Perimeter 2)
+├── docs/ # Documentation (Perimeter 3)
+│   ├── architecture/ # ADRs, specs (Perimeter 2)
+│   └── proposals/ # RFCs (Perimeter 3)
+├── examples/ # Examples (Perimeter 3)
+├── spec/ # Spec tests (Perimeter 3)
+├── tests/ # Test suite (Perimeter 2-3)
+├── .machine_readable/ # ALL machine-readable content (Perimeter 1)
+│   ├── \*.a2ml # State files (STATE, META, ECOSYSTEM, etc.)
+│   ├── bot_directives/ # Bot configs
+│   └── contractiles/ # Policy contracts (k9, dust, lust, must, trust)
+├── .well-known/ # Protocol files (Perimeter 1-3)
+├── .github/ # GitHub config (Perimeter 1)
+│   ├── CONTRIBUTING.md # This file
+│   ├── ISSUE_TEMPLATE/
+│   └── workflows/
+├── CHANGELOG.md
+├── CODE_OF_CONDUCT.md
+├── GOVERNANCE.md
+├── LICENSE
+├── MAINTAINERS.md
+├── README.adoc
+├── SECURITY.md
+├── flake.guix # Guix flake — fallback (Perimeter 1)
+├── guix.scm # Guix package — primary (Perimeter 1)
+└── Justfile # Task runner (Perimeter 1)
+```
 
     ---
 
-    ## How to Contribute
+## How to Contribute
 
-    ### Reporting Bugs
+### Reporting Bugs
 
     **Before reporting**:
     1. Search existing issues
@@ -61,7 +75,7 @@ flake — fallback (Perimeter 1) ├── guix.scm \# Guix package — primary
     - Expected vs actual behaviour
     - Logs, screenshots, or minimal reproduction
 
-    ### Suggesting Features
+### Suggesting Features
 
     **Before suggesting**:
     1. Check the [roadmap](ROADMAP.md) if available
@@ -77,7 +91,7 @@ flake — fallback (Perimeter 1) ├── guix.scm \# Guix package — primary
     - Alternatives considered
     - Which perimeter this affects
 
-    ### Your First Contribution
+### Your First Contribution
 
     Look for issues labelled:
 
@@ -88,22 +102,25 @@ flake — fallback (Perimeter 1) ├── guix.scm \# Guix package — primary
 
     ---
 
-    ## Development Workflow
+## Development Workflow
 
-    ### Branch Naming
+### Branch Naming
 
-docs/short-description \# Documentation (P3) test/what-added \# Test
-additions (P3) feat/short-description \# New features (P2)
-fix/issue-number-description \# Bug fixes (P2) refactor/what-changed \#
-Code improvements (P2) security/what-fixed \# Security fixes (P1-2)
+docs/short-description # Documentation (P3) test/what-added # Test
+additions (P3) feat/short-description # New features (P2)
+fix/issue-number-description # Bug fixes (P2) refactor/what-changed #
+Code improvements (P2) security/what-fixed # Security fixes (P1-2)
 
 
-    ### Commit Messages
+### Commit Messages
 
     We follow [Conventional Commits](https://www.conventionalcommits.org/):
 
-():
+type(scope): description
+
+Body: what changed and why.
 
+Footer: issue reference, e.g. Closes #123
 \[optional body\]
 
 \[optional footer\]