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.