repo-architecture

Identify a page's primary subject and map it to the correct directory.

1|Updated May 9, 2026
One-click install
npx skills add https://github.com/weiping/gbrain-cn --skill repo-architecture-weiping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-architecture
Source: https://github.com/weiping/gbrain-cn/tree/main/skills/repo-architecture
Command: npx skills add https://github.com/weiping/gbrain-cn --skill repo-architecture-weiping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents messy or inconsistent brain-page placement by ensuring new content is filed by primary subject using a shared decision protocol.

Core Features & Use Cases

  • Subject-first filing rules: Places pages into the correct directory based on what the page is primarily about (people, companies, concepts, originals, meetings, media, or raw imports).
  • Ambiguity-safe decision protocol: Provides a stepwise process for choosing the primary subject and handling unclear cases consistently.
  • Quality gate guidance: Enforces a notability gate reference before committing pages into the knowledge system.

Quick Start

File a new page by telling the system the page’s topic and I will return the exact path and reason it belongs there.

Frequently Asked Questions about repo-architecture

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

FAQPage Schema
How do I decide where to file a new knowledge page in my repository architecture?

File new knowledge pages by identifying the primary subject—such as people, companies, concepts, meetings, media, or raw imports—and mapping it to the correct directory using a decision protocol. This prevents filing-by-format and filing-by-source errors.

What is the best way to organize brain pages by primary subject?

Organize brain pages by applying a subject-first filing rule that places pages into directories based on what the page is primarily about. An ambiguity-safe decision protocol handles unclear cases consistently.

How does the quality gate work for knowledge management content filing?

The quality gate enforces a notability reference check before committing pages into the knowledge system. It rejects filing-by-format and filing-by-source errors to maintain repository consistency.

Can I use directory conventions for raw data imports and media files?

Yes, directory conventions apply to raw data imports and media files by resolving their primary subject and mapping them to the correct directory. The system enforces subject-first filing rules across all content types.

Why does cross-linking fail when knowledge pages are filed by format instead of subject?

Cross-linking fails when pages are filed by format because the repository architecture loses its subject-first semantic structure. Filing by primary subject ensures pages map to the correct directory for consistent retrieval and linking.