modify documents

docs/FEATURE_DOCUMENTATION.md

@@ -15,8 +15,9 @@
 3. Specialist는 할당 작업에 관련된 Feature 문서와 원문의 절만 읽는다.
    `FEATURED_AGENTS.md`는 자동 로드되는 `AGENTS.md`가 아니므로 필요한 context는
    메인이 경로·절로 전달한다. 모든 인계에서 핵심 문서 3개를 재독하도록 강제하지 않는다.
-4. 기존 `docs/features/<feature-id>/`와 `coordination.md`는 이력으로 보존한다.
-   자동 이동·복제하지 않고 재개에 필요한 경로·계약 revision을 참조한다.
+4. 과거 단계별 계획·coordination은 현재 작업 입력이 아니다. 별도 문서 정리 요청에서는
+   유효한 결정·승인·실패·검증 근거를 현재 기능 문서에 통합하고 반복 진행 기록을 제거할 수 있다.
+   요구사항·ADR ID와 당시 판정은 보존하며, 이동·삭제 시 저장소의 파일·절 참조를 갱신한다.
    `coordination.md`를 새로 생성하거나 현재 상태 기록을 위해 갱신하지 않는다.
 
 Feature 문서는 공통 기준을 복사하거나 묵시적으로 덮어쓰지 않는다. 실제 상위 계약 문제는
@@ -72,6 +73,23 @@ hash·gate 기록은 요구하지 않는다.
 보고서에서 참조한다. 기존 phase 이력은 새 보고서 형식에 맞추어 변경하지 않는다.
 Reference artifact와 tolerance를 구현 결과에 맞추어 수정하지 않는다.
 
+## 기능 문서 정리 기준
+
+기능별 [README](README.md#기능별-진입점)는 목적·현재 범위와 필요한 문서의 진입점이다.
+파일 수를 고정하지 않으며 짧은 결과 보고서는 `verification.md`, 중요한 수정은
+`lessons.md` 등으로 통합할 수 있다. 기존 PRD·ADR·정식화·I/O의 유효한 의미를 유지한다.
+
+- 최종 수식·가정·단위·부호·좌표·source identity·적용 한계와 공개 I/O를 보존한다.
+- 재사용 책임·수명과 재사용하면 안 되는 조건을 Handoff에 명시한다.
+- 채택 이유·중요한 대안·승인 이력을 유지하고 오래된 실패 원인을 해결 상태와 함께 기록한다.
+- 구현/검증 완료, PASS/FAIL/SKIP/미실행과 보류를 구분하고 과거 readiness를 승계하지 않는다.
+- 실행 revision·환경·명령·native exit·주요 metric·reference identity와 evidence 위치를 유지한다.
+- 최신 날짜나 링크 부재만으로 삭제하지 않는다. 중복은 한 원본으로 통합하고 참조를 수정한다.
+- 삭제한 파일의 과거 원문은 Git revision과 원래 경로로 조회할 수 있게 연결한다.
+
+원시 로그·논문·reference 데이터는 별도 역할이다. 존재하지 않는 개인 artifact를 유효한
+파일 링크로 표시하거나 문서 정리를 이유로 원본을 생성·보정하지 않는다.
+
 ## 언어와 확인
 
 기본 Feature 문서는 한국어 Markdown으로 작성하고 agent/skill ID, field, requirement ID,