📂 Organize Standard v2

핵심 원칙

원칙 1: 폴더 구조는 목적 중심이다. "무엇을 하기 위한 자료인가"를 기준으로 폴더를 구성한다.

원칙 2: 같은 목적의 프롬프트·도메인·코드도메인은 한 폴더 안에 모인다. 작업 시 한 폴더만 열면 모든 재료가 갖춰진다.

원칙 3: 파일명이 곧 내용의 보증서다. 파일명만 보고 "이걸 AI에 주면 이런 결과가 나온다"를 즉시 알 수 있어야 한다.

1. 저장소 구조

Prompts/
├── {목적}/
│   ├── 프롬프트/
│   ├── 도메인/
│   │   └── {세부주제}/
│   └── 코드도메인/
│
└── _검토필요/

목적 폴더명은 귀납적으로 결정한다. 미리 고정하지 않는다. 판단 기준은 Judge-Standard-목적판단 참조.

2. 파일명 규칙

프롬프트

{AI모델}_{목적}_{핵심과업}_v{버전}.md

예)
Claude_문서생성_A4보고서생성_v01.md
GPT_분석_측량데이터요약_v02.md
Gemini_자동화_HWPX일괄변환_v01.md

도메인 — 텍스트 지식

{분야}_{세부주제}_{내용}_v{버전}.md

예)
측량_법규_지적측량성과검사기준_v01.md
토목_설계기준_도로선형허용오차_v01.md

도메인 — CSS/HTML/JS

{용도}_{형식}_{내용}_v{버전}.md

예)
A4보고서_CSS_인쇄레이아웃_v01.md
A4보고서_HTML_3단구조_v01.md
시스템UI_CSS_대시보드레이아웃_v01.md

코드도메인

{기능}_Python_v{버전}.py

예)
HWPX텍스트추출_Python_v01.py
PDF파싱유틸_Python_v01.py
인코딩변환_Python_v01.py

파일명 금지 사항

금지	이유
General, 기타, 기본	목적 불명확
v999, v000	기계적 폴백 이름
한글 깨짐 문자	즉시 폐기

버전 규칙

상황	처리
최초 생성	v01
내용 수정	v02, v03 순차 증가
버전 건너뜀 금지	v01 → v03 불허, 반드시 v02 존재

3. 파일 내부 구조

프롬프트 파일

---
title: A4 보고서 생성 프롬프트
ai_model: Claude
purpose: 문서생성
version: 1.0.0
source_path: geulbeot/app.py
tags: [html, a4, report]
last_updated: 2026-03-05
---

## 페르소나
당신은 전문 퍼블리싱 개발자입니다.

## 절대 원칙
1. 원본 텍스트 절대 변경 금지
2. 3단 구조 필수

## 참조 도메인
{{도메인: ../도메인/A4보고서/A4보고서_CSS_인쇄레이아웃_v01.md}}
{{도메인: ../도메인/A4보고서/A4보고서_HTML_3단구조_v01.md}}

## 제약 조건
- 원본 텍스트 절대 변경 금지
- 분량: {page_count}페이지 이내

## 입력
{content}

## 요청
위 기술 표준을 참조하여 입력 콘텐츠를 A4 보고서로 변환하라.

도메인 파일 — 텍스트 지식

---
title: 지적측량 성과 검사 기준
domain_field: 측량
version: 1.0.0
tags: [측량, 법규, 성과검사]
last_updated: 2026-03-05
---

## 내용
(전문 지식·법규·수치 원문 그대로)

도메인 파일 — CSS/HTML/JS

---
title: A4 인쇄 레이아웃 CSS
domain_field: 시스템UI
version: 1.0.0
tags: [css, a4, print]
last_updated: 2026-03-05
---

## 내용
(CSS/HTML/JS 코드 블록 그대로)

코드도메인 파일

# title: HWPX 텍스트 추출 유틸
# purpose: 한글문서처리
# version: 1.0.0
# last_updated: 2026-03-05

def extract_text_from_hwpx(file_path: str) -> str:
    """재사용 가능한 독립 함수만 포함"""
    ...

4. Switching 연결 방식

프롬프트 파일 내부에서 도메인을 참조하는 문법이다. 파일 내용 수정 없이 도메인 버전만 교체하여 동작을 변경할 수 있다.

참조 문법

{{도메인: ../도메인/{세부주제}/{파일명}}}

버전 스위칭 예시

변경 전: {{도메인: ../도메인/A4보고서/A4보고서_CSS_인쇄레이아웃_v01.md}}
변경 후: {{도메인: ../도메인/A4보고서/A4보고서_CSS_인쇄레이아웃_v02.md}}

무결성 확인 기준

확인 항목	기준
모든 프롬프트에 참조 도메인 명시	도메인 없는 프롬프트는 미완성
참조된 도메인 파일 실제 존재	깨진 링크 0개
버전 번호 연속성	건너뜀 불허

5. 오류 등록 방식

실행 중 발생한 오류는 Gitea 이슈 1개에 모아서 등록한다. 해결 후 위키 해당 페이지 업데이트 → 이슈 Close.

이슈 제목: [YYYY-MM-DD] 추출 오류 로그

[SKIP: Access Denied]          경로
[SKIP: Encoding Error]         경로
[MANUAL: HWP Review Required]  경로
[MANUAL: Review Required]      경로
[INFO: No Prompt Pattern]      경로
[ERROR: File Corrupted]        경로