🗂️ TheColliery — Global Configuration & Landing Page (.github)

This repository houses the global configuration, landing page profile, central installation scripts, and shared developer doctrines for TheColliery organization.

---

⛏️ Active Repositories

• CoalMine: Quality-canary skills suite for AI coding agents.
  
• CoalTipple: Model and effort router with budget protection locks.
  
• CoalBoard: Consensus & debate board — diverse lenses verify error-not-allowed work before it ships.
  
• CoalHearth: Session warm-resume — journals state so an interrupted session resumes from a recovery block instead of a manual rebuild.
  
• CoalFace: Fan-out discipline — scout → waves → QC → one writer, the whole swarm bounded by the estimated solo cost.
  
• CoalWash (beta): Memory washer/defragmenter — cleans class-B memory FAT (never the MEAT) under a code-enforced zero-fact-loss gate, deletes human-gated, apply transactional.
  
• CoalLedger (beta): Docs-health canary suite — CoalMine for documentation (wrong · incomplete · stale · contradictory · broken · unreadable · leaked) over a CommonMark+GFM AST engine, cross-agent + multilingual.
  

---

📦 How to Install the Suite

You can install any or all tools in the series (CoalMine, CoalTipple, CoalBoard, CoalHearth, CoalFace, CoalWash (beta), CoalLedger (beta)) using the central installer located in this repository:

curl -fsSL https://raw.githubusercontent.com/TheColliery/.github/main/install.mjs -o colliery-install.mjs
node colliery-install.mjs all         # the whole suite (all 7)
node colliery-install.mjs 3           # just CoalBoard
node colliery-install.mjs 1 2 3       # CoalMine + CoalTipple + CoalBoard
node colliery-install.mjs 6 7         # CoalWash + CoalLedger (beta)

---

📊 Series Benchmarks

Periodic blind output-quality evaluations and regression tests. To keep them honest, this page links to each tool's RESULTS.md (the single source of truth) and never copies the figures -- so a number here cannot drift from, or be invented apart from, the measured run.

• CoalMine -- defect-detection recall/precision across the full 7-canary suite, multiple engines (Claude tiers + Antigravity cross-vendor). Results: benchmarks/CoalMine/RESULTS.md.
• CoalTipple -- dynamic model escalation + output correctness across 5 domains (crypto, proof, research, legal, voice), Claude Code. Results: benchmarks/CoalTipple/RESULTS.md; routing-cost savings: benchmarks/CoalTipple/ROUTING-SAVINGS.md.
• CoalBoard -- with-the-board-vs-without on error-not-allowed tasks, two platforms (Claude Code reliability + Antigravity cross-vendor), including the honest correlated-blind-spot ceiling. Results: benchmarks/CoalBoard/results/.
• CoalHearth -- interruption damage: cold restart vs warm resume on a 10-file mid-refactor (token delta + the categorical state-fidelity recovery), Claude Code. Results: benchmarks/CoalHearth/RESULTS.md.
• CoalWash -- consecutive-run ceiling + infinity-loop fact-loss, first dated run (fable tier); the headline sawtooth-vs-bloat saving is still unmeasured (protocol, fixtures, and a runnable mechanical scorer are published). Results: benchmarks/CoalWash/RESULTS.md.
• CoalLedger -- not yet measured (launched unbenchmarked rather than with an invented number); the engine's mechanical layer is fixture-gated in-repo, and the first published benchmark will follow the flock shape here.
• CoalFace -- fan-out cost: solo vs ad-hoc vs scout-digest on a shared-context worksite (tokens + dollars + the coarse-pack lever), Claude Code + Antigravity cross-vendor. Results: benchmarks/CoalFace/RESULTS.md.

---

🏛️ Repository Structure

This specific repository (.github) manages the following internal assets:

• profile/README.md: The main landing page displayed on the TheColliery Organization Profile.
• install.mjs: The unified cross-platform DLC selector installation script for all active tools in the suite.
• DESIGN-PRINCIPLES.md: The Quantum 11 performance & design guidelines governing all series projects.
• hooks-safety.md: The Phoenix 13 safety hook commandments (sandboxing, fail-silent execution).
• scripts-quality.md: The CLI and script quality rules for release-gating.
• DOC-PATTERN.md: The shared public-doc pattern (README / SECURITY / CONTRIBUTING / PRIVACY) that keeps every repo's docs sibling-consistent.

---

For the public-facing organization profile, please visit github.com/TheColliery.