Update wiki page '실행원칙'

2026-03-09 11:05:30 +09:00
parent f2b9da79e9
commit 29ce921304

@@ -1,92 +1,18 @@
# 실행 원칙 (Execution Rules)
# 실행원칙 (Execution Rules)
## 기본 원칙
## 1. 기본 원칙: 추출과 정리, 생성 금지
- 본 프로젝트의 본질은 사용자 자산의 **'추출(Extraction)'**과 **'정리(Organization)'**이지, 새로운 프롬프트의 **'생성(Generation)'**이 아니다.
- AI는 파일의 내용을 분석하여 사용자님이 이미 정의한 로직과 지식을 목적별 폴더로 분류하는 '정리 도우미' 역할에 충실한다.
> 위키를 읽고 실행한다. 판단이 모호하면 Judge-Standard를 다시 읽는다.
> 기준서(Judge-Standard, Organize-Standard)는 절대 수정하지 않는다.
> Step이슈 피드백을 받아 개선된다.
## 2. 데이터 처리 원칙
- **순수성 보존**: 원본 파일에 담긴 텍스트를 1%도 변조하거나 임의의 헤더([Persona] 등)를 추가하지 않도로 정리함.
- **수술적 분리**: <20>Vn <20>c붔딼 내에 '지시문'과 '참조 데이터'가 섞여 있다면, 내용의 변형 없이 물리적으로나누어 각각 Prompt와 Domain 폴더에 저장한다.
- **논리적 연결**: 분리된 데이터는 {{Domain: path}} 링크를 통해서만 관계를 표시한다.
---
## 3. 분류 및 보관 기준
- **Prompt**: 사용자님이 AI에게 내린 '명령', '로직', '작업 단계'가 담긴 기존 텍스트.
- **Domain**: 사용자님이 AI에게 제공한 '참조 지식', '데이터', '문서 내용' 등 순수 재료.
- **Version**: 동일한 목적의 내용이 여러 개일 경우 v01, v02 등으로 히스토리를 보존하여 정리한다.
## 1. 실행 순서
1. Judge-Standard 위키 숙지
2. Organize-Standard 위키 숙지
3. Step-00부터 Step-12까지 순서대로 실행
4. 현재 Step 통과 기준 충족 후에만 다음 Step으로 이동
---
## 2. 진행현황 이슈 관리
- "진행현황" 이슈가 없으면 먼저 생성한다
- 각 Step 완료 후 해당 Step의 코멘트 템플릿을 채워 "진행현황" 이슈에 코멘트로 등록한다
- 코멘트는 누적한다. 기존 코멘트를 수정하거나 삭제하지 않는다
### 코멘트 형식
```
### [Step-XX] 단계명 - YYYY-MM-DD
(Step 위키의 코멘트 템플릿 내용 채워서 작성)
→ 결과: 통과 / 재실행 / 이슈 #번호 등록 후 계속 진행
```
---
## 3. 문제 발생 시 처리 절차
**① 별도 이슈 생성**
- 제목: [Step-XX] 문제 내용 요약
- 본문: 문제 상황 구체적으로 기술
**② 이슈에 코멘트 1 — 원인 분석**
```
## 원인 분석
- Step이 적용되지 않은 이유:
- Step 위키의 어느 부분이 부족했는가:
- Judge-Standard 또는 Organize-Standard와의 충돌 여부:
```
**③ 이슈에 코멘트 2 — 변경 대상 및 이유**
```
## 변경이 필요한 부분
- 변경 대상: Step-XX 위키의 어느 섹션
- 현재 내용:
- 변경 제안:
- 변경 이유:
- 다른 Step 영향 여부:
```
**④ 이슈에 코멘트 3 — 해결 방향 및 임시 조치**
```
## 해결 방향 및 임시 조치
- 문제 항목 임시 처리:
- Step 위키 반영 필요 여부: 예 / 아니오
- 반영 후 재실행 필요 여부: 예 / 아니오
- 사용자 판단이 필요한 사항:
```
**⑤ 해결 전까지 해당 항목은 _검토필요로 격리하고 다음 Step을 계속 진행한다**
---
## 4. 승인이 필요한 Step
아래 Step은 결과를 사용자에게 보고하고 승인 후 다음 Step으로 이동한다
| Step | 승인 내용 |
|------|-----------|
| Step-01 | 수집된 파일 목록 |
| Step-03 | 캡처된 파일 목록 |
| Step-04 | 블록 분류 결과 |
나머지 Step은 자율 실행 후 진행현황 이슈에 코멘트만 등록한다
---
## 5. 판단 단위 원칙
- 파일 전체를 하나의 단위로 보지 않는다
- 반드시 블록 단위(함수/변수/섹션/태그)로 해체 후 각 블록을 개별 판단한다
- 하나의 파일에서 프롬프트, 도메인, 코드도메인, 제외가 동시에 나올 수 있다
## 4. 통과 기준
- 결과물 폴더(Prompts_Temp)에 담긴 모든 내용은 사용자님의 원본 파일에서 추출된 것이어야 하며, AI가 임의로 지어낸 내용이 0%여야 한다.