Skip to content

Brain-resident gbrain skillpack so a synced brain keeps its types - #8

Merged
mattzimak merged 1 commit into
mainfrom
feat/gbrain-brain-pack
Sep 16, 2026
Merged

mattzimak merged 1 commit into
mainfrom
feat/gbrain-brain-pack

Conversation

@mattzimak

Copy link
Copy Markdown
Member

What

Adds the gbrain brain-resident skillpack to the template: skillpack.json (brain_resident: true, schema_pack: company-brain), skills/company-brain/SKILL.md, runbooks/bootstrap.md, evals/company-brain.judge.json, a CHANGELOG, and a short README pointer. Everything is additive and optional; nothing existing changes except one appended README section.

Why

A brain in this layout synced into gbrain on its default pack loses its structure. gbrain-base-v2 declares 15 page types, retypes every other type to note, and folds product into company.

Measured, not assumed. gbrain's own dry run on a 15-page sample brain:

$ gbrain jobs submit unify-types --params '{"target_pack":"gbrain-base-v2","apply":false}' --follow
  would retype 8 pages to note and 1 by explicit rule, of 15

The relationships flatten too: a decision page keeps one generic mentions edge instead of decided_in, owned_by and supersedes.

How it was verified

  • gbrain skillpack doctor . -> 8/10 (community): all 5 core dimensions, plus bootstrap runbook and license. The unit/e2e test badges do not apply to a Markdown brain and are left unearned rather than faked.
  • The schema pack this declares lives at mattzimak/gbrain-company-brain (doctor 10/10, unit tests plus an end-to-end test against a real gbrain in CI). Its e2e run asserts 15/15 pages typed and the owned_by, supersedes, decided_in, competes_with, champion and attended edges.
  • scripts/validate-frontmatter.sh only scans the canonical folders and root files, so the new skills/ and evals/ files do not affect it. gitleaks clean.

Notes

Two gbrain limitations found while building this are filed upstream and worked around in the skill's commands: garrytan/gbrain#5142 (fs extraction ignores the active pack, so use --source db --include-frontmatter) and garrytan/gbrain#5143.

🤖 Generated with Claude Code

A brain in this layout synced into gbrain on its default pack loses its
structure: gbrain-base-v2 declares 15 page types, retypes everything else to
note, and folds product into company. Measured on a 15-page sample brain,
gbrain's own unify-types dry run would retype 9 of 15 pages, and the
relationships between them collapse to generic mentions.

This adds the pack gbrain looks for when a harness connects (brain_resident,
schema_pack: company-brain):

- skills/company-brain/SKILL.md - install the company-brain schema pack, sync
  with typed links (extract needs --source db --include-frontmatter), read the
  brain through typed edges, and write back under the curation tiers.
- runbooks/bootstrap.md - what a connecting harness walks through, read AGENTS.md
  and the curation contract first.
- evals/company-brain.judge.json - three judge cases: sync preserves the layout,
  answers are cited and current, writes respect the tiers.
- skillpack.json, CHANGELOG.md, and a short README pointer.

gbrain skillpack doctor scores it 8/10 (community): all 5 core dimensions plus
the runbook and license. The two unit/e2e test badges do not apply to a
Markdown brain, so they are left unearned rather than faked.

The schema pack itself lives at github.com/mattzimak/gbrain-company-brain.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@mattzimak
mattzimak merged commit 31df37a into main Sep 16, 2026
4 checks passed
@mattzimak
mattzimak deleted the feat/gbrain-brain-pack branch September 16, 2026 12:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant