{
  "markdown": "# a-roofers-open-brain\n\n> A property-first, era-aware persistent memory layer for a roofing company — with a 13-agent workforce as its interface.\n>\n> **The agents are the interface. The brain is the asset. The data is the product.**\n\nBuilt and maintained by [Cleverwork](https://cleverwork.io). This repo is the deployable template a single roofing client's brain is provisioned from. Clone it, fill in `config/roofer.config.yaml`, run `scripts/new-client.sh`, and you have an isolated brain running on Supabase + containerized MCPs with Slack-native agents.\n\n---\n\n## Why this exists\n\nThe roofing trade is losing institutional knowledge for the third time in 30 years. The early-90s computing transition and the mid-2000s SaaS transition each stranded a generation of know-how on yellow pads and in retiring foremen's heads. The boomer/Gen-X retirement wave is the third. `a-roofers-open-brain` is the deliberate intervention: capture the knowledge **as the work happens**, stamp it with its era and the code in effect, bind it to the **property** it was performed on, and keep it reliable for 5+ years.\n\nRoofing is unusually property-bound: every job happens at a parcel, in a jurisdiction, under a code version, with a manufacturer warranty and an inspector culture. So the **property is the primary key**, not the client. That one decision unlocks cross-client property history — the moat no competitor can buy.\n\n## What you get\n\n- **13 agents per client.** 5 vertical (client-facing in Slack) + 8 horizontal (infrastructure). See [`AGENTS.md`](AGENTS.md).\n- **A property-first, era-aware schema** that extends the [OB1](https://natebjones.com) memory spine. See [`schemas/`](schemas/).\n- **Roofer-native bridges** — AccuLynx-first, plus CompanyCam, QuickBooks, EagleView, StartInfinity. See [`integrations/bridges/`](integrations/bridges/).\n- **The post-op debrief pipeline + EEAT flywheel + storm-response recipe.** See [`recipes/`](recipes/).\n- **Lean governance baked in** — Six Sigma A3 with a 10x ROI gate, Auditor vs. Quality Control separation, a 5S Maintenance playbook. See [`proposals/`](proposals/) and [`standards/`](standards/).\n- **A workspace front desk for agents** — Hermes/Maintenance keeps the repo map, import triage, naming conformance, and move manifests current so agents do not burn context on the wrong files. See [`agents/horizontal/maintenance/FRONT-DESK.md`](agents/horizontal/maintenance/FRONT-DESK.md).\n\n## Quickstart\n\n```bash\n# 1. Clone\ngit clone <this-repo> a-roofers-open-brain && cd a-roofers-open-brain\n\n# 2. Configure your company (the ONLY file most roofers edit)\ncp config/roofer.config.example.yaml config/roofer.config.yaml\ncp config/.env.example .env\n$EDITOR config/roofer.config.yaml   # company, service area, AccuLynx, jurisdictions, manufacturers\n$EDITOR .env                        # secrets (never commit this file)\n\n# 3. Provision an isolated brain (Supabase project + schema + MCP containers + dashboard)\n./scripts/new-client.sh\n\n# 4. Verify end-to-end\n./scripts/verify-deployment.sh\n```\n\nFull walkthrough: [`docs/01-onboard-a-roofer.md`](docs/01-onboard-a-roofer.md). Stuck? [`docs/TROUBLESHOOTING.md`](docs/TROUBLESHOOTING.md). Customizing beyond the config file: [`docs/CUSTOMIZATION.md`](docs/CUSTOMIZATION.md).\n\n## Repository layout\n\n| Path | What lives here |\n| --- | --- |\n| [`docs/`](docs/) | Architecture brief, onboarding, debrief script, philosophy, model matrix, security, FAQ, troubleshooting, customization |\n| [`schemas/`](schemas/) | `ob1-base/` (vendored OB1 spine, attributed) + `cleverwork-roofer/` (property-first SQL migrations) |\n| [`agents/`](agents/) | `horizontal/` (8 infrastructure agents) + `vertical/` (5 roofer-facing agents) |\n| [`skills/`](skills/) | `_template/`, `infranodus/` (cited), `ob1/` (cited), `cleverwork-roofer/` (originals) |\n| [`integrations/bridges/`](integrations/bridges/) | Data adapters, AccuLynx-first |\n| [`recipes/`](recipes/) | Post-op debrief, EEAT flywheel, storm-response, property + client onboarding |\n| [`standards/`](standards/) | Quality Control's versioned work-product standards (incl. `design/` — the DESIGN.md design-token contract) |\n| [`proposals/`](proposals/) | A3 templates + skill backlog (the 10x ROI gate) |\n| [`server/`](server/) | Deno + MCP container on Hetzner MCP server + smoke tests |\n| [`deployment/`](deployment/) | `remote/` (default: Supabase + Coolify) + `local/` (held in reserve) |\n| [`scripts/`](scripts/) | `new-client.sh`, `verify-deployment.sh`, `kaizen-review.sh` |\n| [`config/`](config/) | `roofer.config.yaml` + `brand/DESIGN.md` — the customization surface |\n| `app/command-center/` | Planned production Astro SSR app home; see [`docs/22-gsd-app-transition-roadmap.md`](docs/22-gsd-app-transition-roadmap.md) |\n| `imports/`, `private/` | Local ignored intake/workbench folders for raw copied projects and client-private files |\n\n## Built on the shoulders of\n\n- **OB1** (Nate B. Jones) — the persistent-memory spine. Schemas, MCP container pattern, recipes, guard rails. Nate gives away practical systems like this: <https://natebjones.com> · <https://substack.com/@natesnewsletter>.\n- **Dynamous workshops** (Cole Medin) — the security + local-sovereignty layer (referenced, not redistributed; see [`LICENSE.md`](LICENSE.md)).\n- **InfraNodus skills** — the cognition layer for the thinking agents (Auditor, QC, Innovator).\n- **Andrej Karpathy's LLM Wiki** — the philosophical pattern: build the wiki once, incrementally; don't re-derive on every query.\n- **DESIGN.md** (Google Labs) — the design-token format every visual asset follows. Spec vendored under `standards/design/vendor/` (Apache-2.0); linter run via `npx @google/design.md`. <https://github.com/google-labs-code/design.md>.\n- **GSD Core** (open-gsd) — the phase loop used for the app transition and future extended projects: Discuss, Plan, Execute, Verify, Ship. Referenced as a toolchain, not vendored by default. <https://github.com/open-gsd/gsd-core>.\n\n## License\n\n**MIT** — see [`LICENSE`](LICENSE). Structured as a fork: all Cleverwork-original work is MIT (use it, fork it, ship it commercially). The four vendored OB1 base schemas keep their FSL-1.1-MIT notice and auto-convert to MIT on OB1's release schedule; Dynamous and InfraNodus are cited concepts only, re-expressed, never redistributed. Full breakdown in [`LICENSE.md`](LICENSE.md).\n\n---\n\n_Status: Scaffold (Phase 0). Generated 2026-05-29 from the v0.1 architecture brief. See [`docs/00-architecture-brief.md`](docs/00-architecture-brief.md)._\n",
  "bytes": 6523,
  "sha": "eb4233658fe33f0ddd1dc2440d345ced07309c503365c048e8e57921f48e29e2",
  "repo_slug": "clvrwrk/a-roofer-open-brain",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_clvrwrk_a_roofer_open_brain_docs_knowled_3fb19205/readme"
}