From b22deb27b05487d5b48c226e93f4d62b658d80a6 Mon Sep 17 00:00:00 2001 From: Matt Zimak <214493822+mattzimak@users.noreply.github.com> Date: Mon, 21 Sep 2026 02:56:47 +0200 Subject: [PATCH 1/2] CI: lint the brain with the gbrain-company-brain action Adds a fourth check, 'Company brain lint', that runs mattzimak/gbrain-company-brain@v0.2.0 on the repository root. It applies the same rules the skillpack runs before a gbrain sync and annotates the pull request on the file that broke. Local run on main: 7 pages, 0 errors, 1 warning (FACTSHEET.md has no frontmatter, by design). Co-Authored-By: Claude Fable 5.1 --- .github/workflows/validate.yml | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml index ed564db..1f2f614 100644 --- a/.github/workflows/validate.yml +++ b/.github/workflows/validate.yml @@ -1,10 +1,11 @@ name: validate -# CI for the intelligence repo. Three checks, all advisory rules made +# CI for the intelligence repo. Four checks, all advisory rules made # deterministic (prose is advisory; CI guarantees it - see docs/ARCHITECTURE.md): # 1. Frontmatter - every canonical file carries the required fields # 2. Secrets - gitleaks scan; a leak fails the build # 3. Links - no broken relative links between Markdown files +# 4. Brain lint - the gbrain-company-brain linter, as a GitHub Action on: pull_request: @@ -23,6 +24,18 @@ jobs: - name: Validate frontmatter on canonical files run: bash scripts/validate-frontmatter.sh + brain-lint: + name: Company brain lint + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + # Same checks gbrain-company-brain runs before a gbrain sync: page types the + # pack declares, pages in the right folder, dated decisions, no dangling + # wikilinks. Findings show up as annotations on the pull request. + - uses: mattzimak/gbrain-company-brain@v0.2.0 + with: + path: . + secrets: name: Secret scan (gitleaks) runs-on: ubuntu-latest From 2bdaf1093252c2e6256fd5d46f9c59c64edcf9fa Mon Sep 17 00:00:00 2001 From: Matt Zimak <214493822+mattzimak@users.noreply.github.com> Date: Mon, 21 Sep 2026 02:58:31 +0200 Subject: [PATCH 2/2] runbooks/bootstrap.md: add frontmatter so the page stays typed in gbrain The new brain lint job flagged it: without frontmatter gbrain syncs the runbook as an untyped page. gbrain's skillpack doctor only requires the file to be non-empty and prints it as is, so frontmatter is safe there. Co-Authored-By: Claude Fable 5.1 --- runbooks/bootstrap.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/runbooks/bootstrap.md b/runbooks/bootstrap.md index 6bee2b3..9b745f6 100644 --- a/runbooks/bootstrap.md +++ b/runbooks/bootstrap.md @@ -1,3 +1,16 @@ +--- +type: runbook +title: "Bootstrap: connect an agent harness to this brain" +status: verified +owner: "{{FOUNDER_NAME}}" +created: 2026-09-16 +updated: 2026-09-21 +last_verified: 2026-09-21 +source_of_truth: manual +tags: [gbrain, skillpack] +audience: internal +--- + # Bootstrap Post-scaffold steps for a harness connecting to this company brain. gbrain