From 950d3828d0cdec809b43b6b0bff3d393734a99e0 Mon Sep 17 00:00:00 2001 From: umsangdon Date: Sat, 15 Aug 2026 08:11:54 +0900 Subject: [PATCH] =?UTF-8?q?docs(knowledge):=20=EB=AC=B8=EC=84=9C=20?= =?UTF-8?q?=EC=8A=B9=EC=9D=B8=20=EC=83=81=ED=83=9C=204=EB=8B=A8=EA=B3=84?= =?UTF-8?q?=20=EC=8A=A4=ED=82=A4=EB=A7=88=20=EC=A0=95=EC=9D=98=20(draft?= =?UTF-8?q?=E2=86=92verified=E2=86=92approved=E2=86=92exported)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 00_운영지침 §4: 구 draft|confirmed 를 4단계로 대체 — verified(원문 검증)· approved(사용자 승인)·exported(JSON 반영). 승격 조건·강등 규칙(원문 개정 시 draft 강등 = 검증 자동 무효화)·건너뛰기 금지 명시 - 기존 65문서는 draft 유지 — 검증 세션 통과분부터 개별 승격 (일괄 변경 금지) - §7 프로그램 연계: 기준값 배포 = approved 이상, 데이터 연동 = exported 만 신뢰 Co-Authored-By: Claude Fable 5 --- resources/knowledge/00_운영지침.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/resources/knowledge/00_운영지침.md b/resources/knowledge/00_운영지침.md index 1bc8f2ef..deb606ec 100644 --- a/resources/knowledge/00_운영지침.md +++ b/resources/knowledge/00_운영지침.md @@ -60,7 +60,7 @@ sources: - doc: <원문 명칭> version: <시행일 YYYY.MM.DD 또는 판본> loc: -status: draft | confirmed # confirmed = 사용자 검토 완료 +status: draft | verified | approved | exported # 4단계 — 아래 '문서 승인 상태' 참조 last_updated: YYYY-MM-DD --- @@ -78,6 +78,19 @@ last_updated: YYYY-MM-DD |---|---|---| ``` +### 문서 승인 상태 (status) — 4단계 (2026-08-15 도입, 구 draft|confirmed 대체) + +| 단계 | 의미 | 승격 조건 | +|---|---|---| +| `draft` | 작성됨 — 원문 검증 전 | (초기값) | +| `verified` | **원문 검증 완료** — 수치·조문 1:1 대조 통과, _최종검증로그에 기록 | 검증 세션에서 원문 대조 통과 | +| `approved` | **사용자 승인** — 기본값 선정 협의까지 완료 (미결·selection pending 없음) | 사용자 검토·확정 | +| `exported` | **JSON 반영 완료** — data_cost_input_value 등 프로그램 데이터로 생성됨 | 데이터 생성 + 해시 등록 | + +- 강등 규칙: 인용 원문이 개정·수정되면 해당 문서는 `verified` 이상이라도 **`draft`로 강등** 후 재검증 (검증 결과 자동 무효화 원칙). +- 승격은 건너뛰지 않는다 (draft→approved 불가). 단 JSON 대상이 아닌 문서는 `approved`가 최종. +- 기존 문서 65건은 전부 `draft` 유지 — 검증 세션에서 통과분부터 개별 승격 (일괄 변경 금지: 검증 없이 상태만 올리는 것 방지). + ## 5. 작성 규칙 - 서술 최소화. 표·목록·식 위주. AI가 재분석하기 쉬운 구조. @@ -145,4 +158,4 @@ last_updated: YYYY-MM-DD - Aislo 계산 로직 구현 시 이 폴더 문서를 스펙으로 사용한다. 코드 주석에 참조 파일명 기재 권장. - 문서와 코드가 불일치하면 문서(현행 법령 근거)를 우선하고 코드를 수정한다. - **설계 기준 = 현행법**(★근본 원칙). 실무문서 값은 스펙이 아니라 참조·검증용이다. 실무 종합비교(`original/실무문서/_종합비교/`)의 ④ Aislo 제안값은 **제안·참고**이며, 현행 범위와 충돌하면 현행을 채택한다. 각 기술문서는 관련 종합비교 주제(01~06)를 검증 근거로 역참조하되(`## 실무 검증 참조` 섹션), 기본값은 현행 조문·별표에서 확정한다. 현행 공백 항목은 실무 라이브러리를 제안값 후보로 두고 사용자가 확정한다. -- `status: draft` 문서는 사용자 검토 전이므로 로직 구현 근거로 쓰기 전 확인 필요. +- `status: draft` 문서는 원문 검증 전이므로 로직 구현 근거로 쓰기 전 확인 필요. 프로그램 기준값 배포는 `approved` 이상, 데이터 파일 연동은 `exported`만 신뢰 (§4 문서 승인 상태 참조).