docs(wiki): P-Reinforce 위키 포맷 정본 문서 — 포맷 질문에 추정 대신 사실 근거 (제안 A/B/C 기존재 매핑표 포함)

This commit is contained in:
2026-06-12 13:51:03 +09:00
parent f140c5904f
commit a97fc7be07
@@ -0,0 +1,57 @@
---
id: p-reinforce-wiki-format
title: "P-Reinforce 위키 포맷 정본"
category: "AI_and_ML"
status: "verified"
verification_status: "applied"
canonical_id: "wiki-format"
aliases: ["위키 포맷", "wikify 포맷", "P-Reinforce 포맷", "위키 문서 형식", "frontmatter 규격", "wiki format"]
duplicate_of: ""
source_trust_level: "S"
confidence_score: 1.0
created_at: 2026-06-12
updated_at: 2026-06-12
tags: ["P-Reinforce", "format", "wikify", "frontmatter", "ASTRA"]
raw_sources: ["E:\\Wiki\\Datacollect\\scripts\\wiki_format.mjs (코드 정본 v3.1)"]
applied_in: ["Datacollect /api/research/synthesize", "ASTRA /wikify (GET /api/wiki/template 소비)"]
github_commit: ""
---
# [[P-Reinforce 위키 포맷 정본]]
## 🎯 한 줄 통찰 (One-line insight)
위키 문서 포맷의 정본은 **코드**`Datacollect/scripts/wiki_format.mjs` (v3.1) 한 곳이며, Datacollect research와 ASTRA `/wikify`가 모두 이 정본을 소비한다 (2026-06-12 통일). 포맷에 대한 질문·개선 제안은 반드시 이 문서(및 코드 정본)와 대조할 것 — 추정으로 답하면 이미 있는 것을 제안하게 된다.
## 🧠 핵심 개념 (Core concepts)
- **YAML Frontmatter (이미 전 문서 강제)**: id·title·category(논리 도메인, 폴더경로 금지)·status·verification_status·canonical_id·**aliases(3-8개 강제)**·duplicate_of·**source_trust_level(S~D 동적 평가)**·**confidence_score(0~1)**·created_at/updated_at·tags·**raw_sources(출처 URL)**·applied_in·github_commit. — "Frontmatter 도입" 제안은 이미 구현된 상태다.
- **의미 단위 헤더 (이미 강제)**: 🎯 한 줄 통찰 / 🧠 핵심 개념 / 🧩 추출된 패턴 / ⚖️ 비교 및 선택 기준(조건부) / 📖 세부 내용 / ⚖️ 모순 및 업데이트 / 🛠️ 적용 사례 / 💻 코드 패턴(조건부) / ✅ 검증 상태 / 🔗 지식 그래프 / 📚 출처 / 📝 변경 이력 — H2 구조가 섹션 청킹(chunkLevelRetrieval)의 분할 기준점으로 동작 중.
- **내부 연결 (이미 강제)**: [[위키링크]] + `## 🔗 지식 그래프`의 상위/루트 up-link 의무 (고아 문서 금지, 규칙 10) + 인라인 [S#] 출처 인용 (규칙 8·15).
- **동적 신뢰도의 소비처**: source_trust_level·confidence_score 는 장식이 아니라 **지식 충돌 시 우선순위 권고의 입력값** (일일 충돌 스캔이 읽음) — 정직 평가 의무 (규칙 9).
## 🧩 추출된 패턴 (Extracted patterns)
- **정본 단일화 패턴**: 포맷 사본을 두 곳에 두면 반드시 어긋난다 → 코드 한 곳(wiki_format.mjs)에서 생성하고 소비자는 API(GET /api/wiki/template)로 받는다. ASTRA 기능 인벤토리와 같은 원리.
- **포맷 질문 대응 규칙**: "포맷에 X를 추가해야 한다"는 제안을 받으면 먼저 이 문서·코드 정본과 대조 — frontmatter/헤더/링크 제안의 대부분은 기존재.
## 📖 세부 내용 (Details)
| 제안 자주 나오는 항목 | 실제 상태 |
|---|---|
| YAML Frontmatter 도입 | ✅ 이미 강제 — 제안 예시(source_url/ingested_at/topic/status/tags)보다 넓은 17개 필드 |
| 출처·수집일 추적성 | ✅ raw_sources + created_at/updated_at + 인라인 [S#] + 📚 출처 섹션 |
| 의미 단위 헤더(H2/H3) | ✅ 이모지 H2 섹션 강제 — 섹션 청킹의 기준점으로 이미 동작 |
| Internal Link 생성 | ✅ [[위키링크]] + 지식 그래프 up-link 의무 (규칙 4·10) |
| 지식 노후도 계산용 메타 | ✅ created_at/updated_at — 주간 Decay Audit이 사용 |
## ⚖️ 모순 및 업데이트 (Contradictions & updates)
- 2026-06-12 이전의 ASTRA `/wikify`는 구식 사본(category 물리경로, 고정 신뢰도 B/0.8, aliases 빈 배열)을 썼다 — v2.2.229에서 정본 소비로 교체됨. 그 이전에 생성된 문서에는 구식 frontmatter가 남아 있을 수 있다.
## ✅ 검증 상태 및 신뢰도
- **상태:** verified · **검증 단계:** applied (코드 정본 + 양쪽 파이프라인 적용 확인)
- **출처 신뢰도:** S · **신뢰 점수:** 1.0
## 🔗 지식 그래프 (Knowledge Graph)
- **상위/루트:** [[AI_and_ML]]
- **관련 개념:** [[ASTRA 자기 아키텍처]], [[Datacollect Architecture]], [[RAG 아키텍처 및 파이프라인 기초]]
- **참조 맥락:** 위키 포맷 질문·개선 제안·신규 파이프라인이 문서를 생성할 때 1순위 근거.
## 📝 변경 이력 (Change history)
- 2026-06-12: 최초 작성 — 포맷 정본 단일화(wiki_format.mjs v3.1) 직후, 포맷 질문에 추정으로 답하는 것을 막기 위해 정착.