docs: fix 7 broken links, update stale critic counts, bump to v0.7.2

- Fixed 7 broken relative links from docs restructure (CONFIG_REFERENCE, SPEC, CONTRIBUTING, reference-implementation paths)
- SKILL.md: '4 independent AI critics' → '6' (matches 6 shipped critics)
- README.md: version badge v0.7.0 → v0.7.2
- Version bump in critic-status.yaml + pyproject.toml
- CHANGELOG v0.7.2 entry added

Author: Akkari

README.md

@@ -5,7 +5,7 @@
 <p align="center">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2ba4c8.svg" alt="MIT License"></a>
   <img src="https://img.shields.io/badge/platform-OpenClaw-2ba4c8" alt="Platform: OpenClaw">
-  <img src="https://img.shields.io/badge/status-v0.7.0-2ba4c8" alt="Status: v0.7.0">
+  <img src="https://img.shields.io/badge/status-v0.7.2-2ba4c8" alt="Status: v0.7.2">
   <a href="https://clawhub.ai/dacervera/quorum"><img src="https://img.shields.io/badge/ClawHub-dacervera%2Fquorum-2ba4c8" alt="Available on ClawHub"></a>
 </p>
 

SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: quorum
-description: Multi-agent validation framework — 4 independent AI critics evaluate artifacts against rubrics with evidence-grounded findings.
+description: Multi-agent validation framework — 6 independent AI critics evaluate artifacts against rubrics with evidence-grounded findings.
 metadata: {"openclaw":{"requires":{"bins":["python3","pip"],"env":["ANTHROPIC_API_KEY","OPENAI_API_KEY"]},"install":[{"id":"clone-repo","kind":"shell","command":"git clone https://github.com/SharedIntellect/quorum.git /tmp/quorum-install && cd /tmp/quorum-install/reference-implementation && pip install -r requirements.txt","label":"Clone Quorum repo and install Python dependencies"}],"source":"https://github.com/SharedIntellect/quorum"}}
 ---
 

critic-status.yaml

@@ -2,7 +2,7 @@
 # Used by tools/validate-docs.py to detect stale documentation.
 # Update this file FIRST when shipping a critic or feature.
 
-version: "0.7.0"
+version: "0.7.2"
 spec_version: "3.0"
 
 critics:

docs/CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes to Quorum will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.7.2] — 2026-03-12
+
+### Documentation — Docs Restructure & README Rewrite (PR #16)
+
+- **README.md** rewritten: ~400 lines → ~120 lines. Focused on what Quorum is, how to run it, and where to go next. First-person voice preserved.
+- **23 docs reorganized** into 6 categorized subdirectories under `docs/`:
+  - `getting-started/` — QUICK_START, INSTALLATION, TUTORIAL, FOR_BEGINNERS, MODEL_REQUIREMENTS
+  - `architecture/` — IMPLEMENTATION, THE_NINE
+  - `critics/` — all critic-specific docs and frameworks
+  - `guides/` — RUBRIC_BUILDING_GUIDE, CROSS_ARTIFACT_DESIGN
+  - `reviews/` — external review snapshots
+  - `configuration/` — CONFIG_REFERENCE
+- **New files:** `docs/getting-started/QUICK_START.md` (zero to running in <5 min), `docs/README.md` (navigation hub)
+- All cross-references updated across 30+ files
+- `validate-docs.py` exclusion updated to match new `docs/reviews/` path
+
+### Fixed
+- 7 broken relative links caused by docs moving one directory deeper (CONFIG_REFERENCE, SPEC, CONTRIBUTING, reference-implementation paths)
+- `SKILL.md` frontmatter: "4 independent AI critics" → "6" (matched shipped state)
+- `README.md` version badge: v0.7.0 → v0.7.2
+
+---
+
 ## [0.7.1] — 2026-03-12
 
 ### Fixed — Self-Validation Findings (PR #14)

docs/architecture/THE_NINE.md

@@ -180,7 +180,7 @@ That's why there are nine.
 
 ---
 
-*The characters in this story correspond to the nine agents defined in the [Quorum Specification](../SPEC.md). Their behaviors, evidence requirements, and interaction patterns are real. The drama is only slightly exaggerated.*
+*The characters in this story correspond to the nine agents defined in the [Quorum Specification](../../SPEC.md). Their behaviors, evidence requirements, and interaction patterns are real. The drama is only slightly exaggerated.*
 
 ---
 

docs/getting-started/FOR_BEGINNERS.md

@@ -66,7 +66,7 @@ That's it. No build step. No configuration files to wrestle with. No Docker cont
 
 ## "But where's the code?"
 
-Right here: [`reference-implementation/`](../reference-implementation/)
+Right here: [`reference-implementation/`](../../reference-implementation/)
 
 ```bash
 cd reference-implementation

docs/getting-started/INSTALLATION.md

@@ -55,7 +55,7 @@ models:
 depth: standard    # quick | standard | thorough
 ```
 
-See [CONFIG_REFERENCE.md](CONFIG_REFERENCE.md) for full options and [MODEL_REQUIREMENTS.md](MODEL_REQUIREMENTS.md) for supported models.
+See [CONFIG_REFERENCE.md](../configuration/CONFIG_REFERENCE.md) for full options and [MODEL_REQUIREMENTS.md](MODEL_REQUIREMENTS.md) for supported models.
 
 ## Requirements
 
@@ -66,7 +66,7 @@ See [CONFIG_REFERENCE.md](CONFIG_REFERENCE.md) for full options and [MODEL_REQUI
 
 ## Troubleshooting
 
-**"No model configured"** — Run `quorum run` once and follow the first-run setup prompts, or manually create `quorum-config.yaml` (see [CONFIG_REFERENCE.md](CONFIG_REFERENCE.md)).
+**"No model configured"** — Run `quorum run` once and follow the first-run setup prompts, or manually create `quorum-config.yaml` (see [CONFIG_REFERENCE.md](../configuration/CONFIG_REFERENCE.md)).
 
 **"API key not found"** — Set your provider's API key as an environment variable:
 ```bash

docs/getting-started/MODEL_REQUIREMENTS.md

@@ -4,7 +4,7 @@ Quorum's critics need models that can reason about complex artifacts, follow str
 
 ## Tier System
 
-Quorum uses a two-tier architecture. **Tier 1** handles judgment-heavy roles (supervisor, aggregator, security critic). **Tier 2** handles pattern-matching roles (correctness, completeness, architecture critics). See [CONFIG_REFERENCE.md](CONFIG_REFERENCE.md) for which roles map to which tier.
+Quorum uses a two-tier architecture. **Tier 1** handles judgment-heavy roles (supervisor, aggregator, security critic). **Tier 2** handles pattern-matching roles (correctness, completeness, architecture critics). See [CONFIG_REFERENCE.md](../configuration/CONFIG_REFERENCE.md) for which roles map to which tier.
 
 ### Tier 1 — Recommended (Judgment Roles)
 
@@ -49,7 +49,7 @@ models:
   tier_2: anthropic/claude-sonnet-4-6    # Evaluation roles (correctness, completeness, architecture)
 ```
 
-For per-critic overrides, see [CONFIG_REFERENCE.md](CONFIG_REFERENCE.md).
+For per-critic overrides, see [CONFIG_REFERENCE.md](../configuration/CONFIG_REFERENCE.md).
 
 **First-run behavior:** If no config exists, Quorum auto-detects your available model, asks two setup questions (preferred tier 1 and tier 2 models), writes the config, and proceeds immediately. Zero-config users get sensible defaults.
 

docs/guides/RUBRIC_BUILDING_GUIDE.md

@@ -23,7 +23,7 @@ Before you start, you need:
 1. **The source document in parseable format.** PDFs with embedded text work fine; scanned PDFs need OCR. See Step 1.
 2. **Domain knowledge.** This is non-negotiable. Standards are dense, and normative decomposition without domain knowledge produces rubrics that are technically correct and practically useless. The criteria generation step (Step 3) is where expertise matters most.
 3. **A clear scope boundary.** Full standards are large. Decide upfront which sections or requirement types you're encoding. Scope creep kills rubric projects.
-4. **The Quorum rubric schema.** See [CONFIG_REFERENCE.md](CONFIG_REFERENCE.md) for the full spec. A rubric is a JSON file; critics consume it at evaluation time.
+4. **The Quorum rubric schema.** See [CONFIG_REFERENCE.md](../configuration/CONFIG_REFERENCE.md) for the full spec. A rubric is a JSON file; critics consume it at evaluation time.
 
 ---
 
@@ -353,4 +353,4 @@ These assume focused work, good source quality, and pre-existing domain expertis
 
 ---
 
-*Questions or rubric contributions → [CONTRIBUTING.md](../CONTRIBUTING.md)*
+*Questions or rubric contributions → [CONTRIBUTING.md](../../CONTRIBUTING.md)*

reference-implementation/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quorum-validator"
-version = "0.7.0"
+version = "0.7.2"
 description = "Multi-critic quality validation for agents, research, and configurations"
 authors = [
     {name = "Daniel Cervera", email = "daniel@sharedintellect.com"},