CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

repo-architecture

Where new brain files go. Decision protocol for filing brain pages by primary subject, not by format or source. Reference for all brain-writing skills.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugin-variants/gbrain-coding/skills/repo-architecture/SKILL.md

The canonical home for this skill is repo-architecture in garrytan/gbrain

SKILL.md
Quality
Evals
Security

Repo Architecture — Filing Rules

Full filing rules: See skills/_brain-filing-rules.md

Contract

This skill guarantees:

  • Every new page is filed by primary subject (not format, not source)
  • The decision protocol is followed for ambiguous cases
  • Common misfiling patterns are caught

Phases

  1. Identify the primary subject. What would you search for to find this page?
  2. Walk the decision tree:
    • About a person → people/{name-slug}.md
    • About a company → companies/{name-slug}.md
    • A reusable concept/framework → concepts/{slug}.md
    • An original idea → originals/{slug}.md
    • A meeting → meetings/{slug}.md
    • Media content → media/{type}/{slug}.md
    • Raw data import → sources/{slug}.md
  3. Cross-link. Link from related directories.
  4. Check notability. See skills/conventions/quality.md notability gate.

Output Format

Advisory: "File this at {type}/{slug}.md because the primary subject is {reason}."

When it fails

Follow the agent operator protocol for any gbrain error code, exit code, [AGENT] block or notice block. Specific to this skill:

  • list_pages / search cannot find a matching directory or the brain is unreachable: fall back to skills/_brain-filing-rules.md and say the placement came from the rules, not the live brain.
  • get_page returns page_not_found for the page being filed: confirm the slug with the user before choosing a directory.

Anti-Patterns

  • Filing by format ("it's a PDF so it goes in sources/")
  • Filing by source ("it came from email so it goes in sources/")
  • Creating pages without checking if one already exists
  • Using sources/ for anything except raw data dumps
Repository

garrytan/gbrain

Path

plugin-variants/gbrain-coding/skills/repo-architecture/SKILL.md

Last updated
First committed

Canonical home

garrytan/gbrain
In sync

since Jul 24, 2026

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.