repo-architecture

Organize brain files by primary subject using a structured decision protocol.

2|1|Updated Jun 16, 2026
One-click install
npx skills add https://github.com/bish-x/bx-gbrain --skill repo-architecture-bish-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-architecture
Source: https://github.com/bish-x/bx-gbrain/tree/main/skills/repo-architecture
Command: npx skills add https://github.com/bish-x/bx-gbrain --skill repo-architecture-bish-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of organizing brain files efficiently by providing a structured filing system and decision protocol.

Core Features & Use Cases

  • Structured Filing: Ensures every new page is filed by primary subject, not format or source.
  • Decision Protocol: Offers a clear decision tree for ambiguous cases and common misfiling patterns.
  • Cross-Linking: Promotes cross-linking from related directories for easy navigation.
  • Notability Check: Encourages checking the notability of new pages to maintain quality.

Quick Start

Use the repo-architecture skill to file a new brain page about a company by running 'file new page company "Company Name"'

Frequently Asked Questions about repo-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize brain files by primary subject instead of format?

Brain filing with a decision protocol ensures every new page is categorized by its primary subject. It uses a structured decision tree to resolve ambiguous cases and correct common misfiling patterns.

How do I handle ambiguous pages when filing my brain repository?

Resolve ambiguous brain filing cases by applying a structured decision protocol. This provides a clear decision tree to navigate misfiling patterns and accurately determine the primary subject directory.

What is the best way to maintain quality when adding new brain pages?

Maintain brain filing quality by performing notability checks on new pages and promoting cross-linking from related directories. This ensures content relevance and enables easy repository navigation.

How do I file a new brain page about a specific topic like a company?

File a new company brain page by executing the designated filing command with the subject type and name. This triggers the decision protocol to place the page in the correct primary subject directory.

Does brain filing with a decision protocol support cross-linking between directories?

Yes, brain filing with a decision protocol supports cross-linking from related directories. This establishes structured navigation and ensures connections are built between relevant subject areas.