repo-architecture

Determine repository directory paths for new brain pages by primary subject.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ngochuy13/intern-dev --skill repo-architecture-ngochuy13
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-architecture
Source: https://github.com/ngochuy13/intern-dev/tree/main/skills/repo-architecture
Command: npx skills add https://github.com/ngochuy13/intern-dev --skill repo-architecture-ngochuy13

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the confusion and inconsistency of where new knowledge (“brain files”) should be stored by providing a single filing protocol based on the primary subject rather than format or source.

Core Features & Use Cases

  • Primary-subject decision protocol: Selects the correct directory (people, companies, concepts, originals, meetings, media, or sources) by what the page is fundamentally about.
  • Ambiguity handling and misfiling prevention: Uses a decision tree so similar-looking pages don’t get routed incorrectly (e.g., avoiding filing by “PDF-ness” or “came from email”).
  • Cross-linking and notability gate: Encourages linking from related directories and applies a quality/notability check before finalizing a page.

Quick Start

When you create a new page, ask the repo-architecture skill where it should go and what path to use based on its primary subject.

Frequently Asked Questions about repo-architecture

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

FAQPage Schema
How do I determine the correct directory path for filing markdown pages in a knowledge repository?

To determine the correct directory path for filing markdown pages, apply a primary-subject decision protocol that routes files into directories like people, companies, or concepts. This prevents misfiling by format, ensuring consistent repository architecture.

What is the best way to organize a knowledge management repository without misfiling by document format?

The best way to organize a knowledge management repository without misfiling by format is using a decision-tree protocol. It categorizes content by primary subject rather than source, routing pages into folders like media or sources to maintain clean markdown organization.

Why does my repository architecture strategy fail when filing content based on where it came from?

Your repository architecture strategy fails when filing content based on source because it leads to misfiling. A primary-subject decision protocol avoids routing by attributes like "came from email," using a decision tree to map content to concept or company directories.

Can I use a decision tree to prevent duplicate brain pages when adding raw data imports?

Yes, you can use a decision tree to prevent duplicate brain pages when adding raw data imports. The repository architecture protocol checks for existing pages before finalizing, outputting an advisory filename to ensure consistent knowledge organization.

When do I need a notability gate check for new markdown files in a content filing system?

You need a notability gate check for new markdown files in a content filing system before finalizing a page. This quality check is applied after determining the correct directory path, ensuring only notable content is committed to the repository architecture.

Does the repo-architecture skill support cross-linking between different directories like people and companies?

Yes, the repo-architecture skill supports cross-linking between directories like people and companies. It encourages linking from related directories after selecting the correct path and passing the notability gate, enhancing overall knowledge management and content discovery.