repo-architecture

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Repo Architecture — Filing Rules

仓库架构 — 归档规则

Full filing rules: See
skills/_brain-filing-rules.md
完整归档规则: 请查看
skills/_brain-filing-rules.md

Contract

约定

This skill guarantees:
  • Every new page is filed by primary subject (not format, not source)
  • The decision protocol is followed for ambiguous cases
  • Common misfiling patterns are caught
本技能保证:
  • 每个新页面都按主题归档(而非格式或来源)
  • 模糊场景遵循决策流程
  • 识别常见错误归档模式

Phases

步骤

  1. Identify the primary subject. What would you search for to find this page?
  2. Walk the decision tree:
    • About a person →
      people/{name-slug}.md
    • About a company →
      companies/{name-slug}.md
    • A reusable concept/framework →
      concepts/{slug}.md
    • An original idea →
      originals/{slug}.md
    • A meeting →
      meetings/{slug}.md
    • Media content →
      media/{type}/{slug}.md
    • Raw data import →
      sources/{slug}.md
  3. Cross-link. Link from related directories.
  4. Check notability. See
    skills/conventions/quality.md
    notability gate.
  1. 确定主题:你会用什么关键词搜索这个页面?
  2. 遵循决策树:
    • 关于个人 →
      people/{name-slug}.md
    • 关于公司 →
      companies/{name-slug}.md
    • 可复用的概念/框架 →
      concepts/{slug}.md
    • 原创想法 →
      originals/{slug}.md
    • 会议记录 →
      meetings/{slug}.md
    • 媒体内容 →
      media/{type}/{slug}.md
    • 原始数据导入 →
      sources/{slug}.md
  3. 交叉链接:从相关目录添加链接。
  4. 检查显著性:请查看
    skills/conventions/quality.md
    中的显著性标准。

Output Format

输出格式

Advisory: "File this at
{type}/{slug}.md
because the primary subject is {reason}."
建议格式:“将此文件归档至
{type}/{slug}.md
,因为主题是{原因}。”

Anti-Patterns

反模式

  • Filing by format ("it's a PDF so it goes in sources/")
  • Filing by source ("it came from email so it goes in sources/")
  • Creating pages without checking if one already exists
  • Using
    sources/
    for anything except raw data dumps
  • 按格式归档(“这是PDF所以放到sources/目录”)
  • 按来源归档(“来自邮件所以放到sources/目录”)
  • 创建页面时未检查是否已存在同名页面
  • 将非原始数据转储的内容放入
    sources/
    目录