Update wiki page 'Step 12'

2026-03-09 10:26:11 +09:00
parent ca863e7ed2
commit f2b9da79e9

@@ -1,88 +1,7 @@
# Step 12. 최종 Audit (The Ultimate Audit)
## 목적
구축된 라이브러리 전체를 검증하는 최종 방어선이다.
이 기준은 절대 변경하지 않는다.
Step-12 실패 시 원인이 된 Step을 찾아 해당 Step 위키를 수정하고 Step-00부터 재실행한다.
---
## Audit 기준
### 기준 A. 프롬프트 폴더 검사
각 프롬프트 파일을 열어 아래를 확인한다
1. 실제로 사용 가능한 지시문인가
- AI에 그대로 입력했을 때 의도한 작업이 시작되는가
- 단순 코드 추출물, API 호출 코드, 완성된 보고서 본문이 아닌가
2. 가변 블록이 있어 반복 재사용이 가능한가
- 입력값을 바꿔가며 반복 사용할 수 있는 구조인가
3. 참조 도메인이 연결되어 있고 해당 파일이 실제 존재하는가
### 기준 B. 도메인 폴더 검사
각 도메인 파일을 열어 아래를 확인한다
1. 프롬프트가 참조했을 때 실제로 도움이 되는 재료인가
- 작업 수행에 필요한 지식, 기준, 템플릿, 코드 등이 담겨있는가
2. 내용이 온전히 보존되어 있는가
- 깨진 한글, 잘린 내용, 빈 파일이 없는가
3. 다른 분류(프롬프트 지시문, 일회성 실행 코드 등)가 섞여있지 않은가
### 기준 C. 코드도메인 폴더 검사
각 코드도메인 파일을 열어 아래를 확인한다
1. 다른 프로젝트에 그대로 가져다 써도 동작하는가
- API 키, 절대 경로, 프로젝트 고유 변수가 포함되어 있지 않은가
2. 함수·클래스 단위로 독립 완결되어 있는가
### 기준 D. 전체 구조 검사
1. Organize-Standard 파일명 규칙을 준수하고 있는가
2. Organize-Standard 폴더 구조 규칙을 준수하고 있는가
3. 깨진 한글 파일명이 없는가
4. 빈 폴더가 없는가
---
## 판정
### 통과 조건
기준 A, B, C, D 모두 이상 없음 → 전체 완료
### 실패 시 처리 (Loop)
1. 실패한 파일과 기준을 이슈에 기록한다
2. 어느 Step에서 발생한 문제인지 원인을 추적한다
3. 해당 Step 위키에 개선 내용을 반영한다
4. Step-00부터 재실행한다
---
## 진행현황 이슈 코멘트 템플릿
```
### [Step-12] 최종 Audit - YYYY-MM-DD (N회차)
[기준A 프롬프트] 실패 항목:
[기준B 도메인] 실패 항목:
[기준C 코드도메인] 실패 항목:
[기준D 전체구조] 실패 항목:
→ 최종 판정: 전체 완료 / 실패 → Step-XX 위키 수정 후 Step-00 재실행
```
---
## Gitea 등록 (MCP 호출)
1. "진행현황" 이슈 번호 확인
2. 코멘트 템플릿을 채운다
3. create_issue_comment 호출
실패 시:
1. create_issue 호출 → 제목: [Step-12] Audit 실패 - 원인 Step-XX
2. 해당 이슈에 create_issue_comment 3회 호출
- 코멘트 1: 실패 항목 및 원인 분석 (어느 Step의 문제인가)
- 코멘트 2: 해당 Step 위키 변경 내용 및 이유
- 코멘트 3: Step-00 재실행 선언 및 예상 개선 사항
# Step 12. 최종 감사 (Final Audit)
## 1. 목적 (Objective)
전체 공정의 결과물이 위키 Standard와 사용자 의도에 완벽히 부합하는지 최종 점검하고 프로젝트를 완결함.
## 2. 수행방법 (Methodology)
- 물리 구조 무결성, 참조 링크 작동 여부, 프롬프트 지능화 수준 전수 조사.
## 3. 통과 기준 (Success Criteria)
- 자가 감사 보고서(Final_Audit_Report.md) 생성 및 이슈 #46 최종 완료 선언.