repo-architecture

Classify new knowledge-base pages by primary subject into repo directories.

5|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/GYF0311/lorekit --skill repo-architecture-gyf0311
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-architecture
Source: https://github.com/GYF0311/lorekit/tree/main/brain/skills/repo-architecture
Command: npx skills add https://github.com/GYF0311/lorekit --skill repo-architecture-gyf0311

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents misfiled wiki pages by enforcing a consistent decision protocol for where new “brain” content belongs based on its primary subject rather than its format or source.

Core Features & Use Cases

  • Subject-based filing contract: Ensures each new page is placed under the correct directory (people, companies, concepts, originals, meetings, media, or sources) using a primary-subject decision tree.
  • Ambiguity handling guidance: Guides the agent through a structured set of phases to resolve unclear cases before creating or linking pages.
  • Quality and cross-linking expectations: Encourages linking from related directories and applying a notability gate to avoid low-quality placements.

Quick Start

File this page at the directory that matches its primary subject and explain the reason using the protocol in Repo Architecture.

Frequently Asked Questions about repo-architecture

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

FAQPage Schema
How do I file wiki pages by primary subject to prevent misclassification?

File wiki pages by primary subject using a structured decision tree that evaluates content across people, companies, concepts, and other directories. This enforces a consistent placement protocol to reduce misclassification and maintain repository organization.

What is the best way to organize a knowledge base when a new page fits multiple categories?

Handling ambiguous knowledge base pages requires following structured decision phases to resolve unclear cases before creation. The protocol guides you through checking existing pages and applying notability gates to determine the correct target path for cross-linking.

How does cross-linking work for new entries in a wiki directory structure?

Cross-linking in a wiki directory structure works by connecting a newly filed page to related directories after its primary subject placement is finalized. This ensures consistent navigation and reduces broken organization across the knowledge base repository.

When do I need to apply notability rules before creating a new brain-writing page?

Apply notability rules during brain-writing and wiki authoring when deciding the correct target path for a new page. This quality gate prevents low-quality placements by verifying the content meets standards before finalizing its directory location.

Can I use a subject-based filing contract for meetings, media, and source imports?

Yes, a subject-based filing contract applies to meetings, media, originals, and source imports. It standardizes how new knowledge-base pages are filed by evaluating the primary subject rather than the format to determine the correct directory target.

Why does wiki organization break down when pages are filed by format instead of subject?

Wiki organization breaks down because filing by format or source ignores the primary subject, leading to misfiled pages and broken directory structures. Enforcing a subject-based decision protocol ensures consistent placement across the knowledge base.