4.5 KiB
4.5 KiB
id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, tags, raw_sources, applied_in, github_commit
| id | title | category | status | verification_status | canonical_id | aliases | duplicate_of | source_trust_level | confidence_score | created_at | updated_at | tags | raw_sources | applied_in | github_commit | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| p-reinforce-wiki-format | P-Reinforce 위키 포맷 정본 | AI_and_ML | verified | applied | wiki-format |
|
S | 1.0 | 2026-06-12 | 2026-06-12 |
|
|
|
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) 직후, 포맷 질문에 추정으로 답하는 것을 막기 위해 정착.