From a97fc7be07312bb937d6643a6efe35545aaadda0 Mon Sep 17 00:00:00 2001 From: g1nation Date: Fri, 12 Jun 2026 13:51:03 +0900 Subject: [PATCH] =?UTF-8?q?docs(wiki):=20P-Reinforce=20=EC=9C=84=ED=82=A4?= =?UTF-8?q?=20=ED=8F=AC=EB=A7=B7=20=EC=A0=95=EB=B3=B8=20=EB=AC=B8=EC=84=9C?= =?UTF-8?q?=20=E2=80=94=20=ED=8F=AC=EB=A7=B7=20=EC=A7=88=EB=AC=B8=EC=97=90?= =?UTF-8?q?=20=EC=B6=94=EC=A0=95=20=EB=8C=80=EC=8B=A0=20=EC=82=AC=EC=8B=A4?= =?UTF-8?q?=20=EA=B7=BC=EA=B1=B0=20(=EC=A0=9C=EC=95=88=20A/B/C=20=EA=B8=B0?= =?UTF-8?q?=EC=A1=B4=EC=9E=AC=20=EB=A7=A4=ED=95=91=ED=91=9C=20=ED=8F=AC?= =?UTF-8?q?=ED=95=A8)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../AI_and_ML/P-Reinforce 위키 포맷 정본.md | 57 +++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 10_Wiki/Topics/AI_and_ML/P-Reinforce 위키 포맷 정본.md diff --git a/10_Wiki/Topics/AI_and_ML/P-Reinforce 위키 포맷 정본.md b/10_Wiki/Topics/AI_and_ML/P-Reinforce 위키 포맷 정본.md new file mode 100644 index 00000000..278aad18 --- /dev/null +++ b/10_Wiki/Topics/AI_and_ML/P-Reinforce 위키 포맷 정본.md @@ -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) 직후, 포맷 질문에 추정으로 답하는 것을 막기 위해 정착.