내용 우선 Markmap 마인드맵

프로젝트, 문서, 코드베이스 또는 개념을 Markmap으로 렌더링 가능한 Markdown으로 정리하고, 필요 시 구조를 검증하고 HTML을 생성합니다.

핵심 규칙

전체 → 세부 순서: 루트 주제는 대상과 목적을 설명하고, 실제 주요 개념, 프로세스, 모듈, 세부 사항으로 확장합니다.
재료 자체로 마인드맵 구성: 일반 독자를 위해 빈 카테고리 제목을 만들지 마십시오.
분류 역할만 하는 제목 제거: "프로젝트 포지셔닝", "운영 메커니즘", "개발 로드맵", "핵심 개념", "주요 모듈", "사용 시나리오" 등은 원문의 일부가 아닌 이상 사용하지 마십시오.
각 노드의 직접 자식 노드는 최대 7개: 가능하면 5개 내외로 유지하고, 내용이 정말로 필요할 때만 6-7개로 확장합니다.
실제 내용이 많다고 7개를 초과하지 마십시오: 재료의 실제 하위 주제에 따라 계속 그룹화합니다.
7개 초과 시: 비슷한 내용을 먼저 병합한 후 "전체 → 그룹 → 세부" 순으로 재배열합니다.
유사성은 선택 사항: 기억에 도움이 될 때만 내용 태그 뒤에 추가하며, 노드의 주체가 되어서는 안 됩니다.
추측 금지: 저장소 요약 전에 README, 문서, 패키지 설정, 테스트, 소스 코드 디렉토리, 로컬 스크립트를 먼저 확인하십시오.
간결성 유지: 노드는 짧은 내용 태그를 사용하고, 필요 시 근거 있는 설명을 한 문장 추가합니다.

복잡한 저장소나 긴 문서를 처리할 때는 먼저 references/analogy-structure.md를 읽으십시오.

재료 먼저 확인
- 저장소: README, AGENTS.md/CLAUDE.md, 패키지 설정, 문서, 최상위 디렉토리 확인.
- 문서: 주제, 주장, 섹션, 반복되는 개념, 기억해야 할 용어 찾기.
전체 → 세부 순으로 Markdown 초안 작성
- H1 루트 제목으로 대상을 설명합니다.
- ##으로 실제 내용의 뼈대를 확장하며, "독자를 위한 분류 상자"는 사용하지 않습니다.
- 각 노드는 재료의 실제 개념, 시스템, 프로세스, 파일 경로, API, 주장 또는 책임을 우선 작성합니다.
- 이해에 도움이 될 때만 세부 사항을 확장하고, 억지로 가지를 추가하지 않습니다.
- 각 부모 노드의 직접 자식 노드는 최대 7개, 가능하면 5개 내외; 7개 초과 시 실제 하위 주제로 다시 그룹화합니다.
스크립트로 Markdown 검증:

python3 ~/.codex/skills/markmap-analogy-mindmap/scripts/validate_and_render.py input.md --validate-only

python3 ~/.codex/skills/markmap-analogy-mindmap/scripts/validate_and_render.py input.md -o output.html

검증 실패 시 마인드맵 구조를 먼저 수정합니다. 사용자가 명시적으로 비표준 마인드맵을 요청하지 않는 한 "빈 카테고리" 및 "계층별 가지 수 초과" 검사를 우회하지 마십시오.

스크립트는 다음 순서로 시도합니다:

사용 가능한 렌더러가 없으면 검증된 Markdown을 결과물로 제공하고 HTML이 생성되지 않았음을 설명합니다.