agentleFS
cookyman74cookyman74/llmwiki-harness/.claude/skills/wiki-moc/SKILL.md

wiki-moc

Skill34 starsChanged 3 months agoMITView on GitHub

How to build and maintain the MoC (Map of Content) navigation layer of the LLM wiki — create/refresh topical MoC hub pages, keep the home-moc hierarchy coherent, graft new pages into the right map, and ensure every page is reachable from a MoC. Use for MoC 생성/갱신, 네비게이션 정리, 지도 페이지, 새 페이지 편입.

The file

Files
SKILL.md

wiki-moc

MoC(Map of Content)는 위키의 네비게이션 뼈대다. 큐레이션된 허브 페이지가 관련 노트를 주제별로 묶어, 폴더 계층이나 그래프 뷰 없이도 위키를 항해하게 한다.

MoC vs index.md — 섞지 마라

index.mdMoC
성격전수 카탈로그 (기계적)큐레이션 주제 지도 (사람이 읽음)
범위모든 페이지 1회씩주제별 선별·그룹핑
갱신인제스트마다 자동주제 성장 시 큐레이션
계층평면 (카테고리별)계층적 (home → 주제 → 하위)

둘 다 유지한다. index는 "빠짐없이", MoC는 "이해되게".

MoC 페이지 구조

wiki/moc/{topic}-moc.md:

---
type: moc
title: <한국어 주제명> MoC
aliases: [<주제명> 지도]
tags: [moc, <topic>]
created: <오늘>
updated: <오늘>
---

# <한국어 주제명> MoC

> [!info]
> <이 지도가 다루는 범위 1–2문장. 손수 쓴 서문 — 갱신 시 보존.>

## 상위
- [[home-moc]]

## 노트
<!-- 아래는 자동 갱신 구역: 편입된 페이지 목록 -->
- [[page-a]] — <한 줄 설명>
- [[page-b]] — <한 줄 설명>

### <하위 테마 그룹>
- [[page-c]] — <설명>

## 미작성 (stub)
- [[topic-to-write]]

계층

  • 최상위 허브: wiki/moc/home-moc.md — 모든 주제 MoC를 가리킨다. 위키의 현관.
  • 각 주제 MoC는 ## 상위에서 [[home-moc]](또는 부모 MoC)로 되돌아 링크 — 양방향 항해.
  • 주제가 비대해지면(20+ 페이지) 하위 MoC로 분할하고 부모에 링크. 얇으면(2–3) 병합 제안.

절차

신규 MoC 생성: 위 구조로 만들고, 관련 페이지를 ## 노트에 그룹핑 + 한 줄 설명. home-moc에 이 MoC 링크 추가. index.md에도 등록.

기존 MoC 갱신: 손수 쓴 서문·수동 섹션은 보존하고, ## 노트 자동 구역만 재생성. updated: 갱신.

신규 페이지 편입 (인제스트 후): 각 새 페이지의 주제를 판단해 알맞은 MoC의 ## 노트에 한 줄 설명과 함께 추가. 맞는 MoC가 없으면 새 MoC 생성 또는 사용자에게 확인. 귀속 모호하면 "미분류" 섹션 임시 배치.

도달성 점검: 모든 L3-semantic·L4-procedural 페이지가 ≥1 MoC에서 도달 가능한지 확인. L1-working·L2-episodic 기록(세션·소스)은 MoC 대상 아님(휘발·증거 계층). link-audit.py의 orphan에 더해, MoC에서 시작한 링크 그래프로 도달 불가 L3/L4 페이지를 찾아 편입 대상으로 보고.

큐레이션 원칙

MoC는 모든 링크를 쏟아붓는 곳이 아니다 — 주제 응집도에 맞게 선별·그룹핑하고, 각 링크에 왜 여기 있는지 한 줄 설명을 붙인다. 좋은 MoC는 그 자체로 주제 개요처럼 읽힌다.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.