# Code 폴더

**코드·스크립트 산출물**을 저장하는 폴더입니다. ([F3])
> 본 문서는 `.claude/taskexecutionagent.md` **v0.3.01**의 [F3]·[V13]에 종속됩니다.

## 규칙
- 소스 코드, 스크립트, 설정 파일은 모두 이 폴더에 **해당 언어의 표준 확장자**로 저장합니다.
- 코드에 대한 문서화·설명은 `.md`로 작성하여 `DOC/`에 둡니다.
- 언어·모듈·기능별로 하위 폴더를 만들어 분리합니다.
- **코드 파일(`.py`·`.js`·`.html` 등)과 바이너리(`.pptx`·`.dxf` 등)를 `DOC/` 하위에 두지 않습니다.**

## 스크립트 보관 의무 ([F3])
**산출물 생성·검증·변환에 사용한 스크립트는 결과 채택 여부와 무관하게 반드시 보관합니다.**
- 대상: 패치 스크립트, 검증 스크립트, 파서, 렌더러, 대조·집계 도구 등 **일회성으로 작성한 것 포함**
- **검증 스크립트가 보관되지 않은 경우 해당 [Step 3] 검증 결과는 무효**로 간주하며, `PASS` 판정을 인용할 수 없습니다.

## 권장 하위 구조
```
Code/
├── patch/     # 일회성 패치·변환 스크립트 (재실행 시 앵커 불일치로 안전 중단되도록 작성)
├── verify/    # 회귀 검증 스크립트 (반복 실행 가능해야 함)
├── deploy/    # 배포·빌드 스크립트
└── <언어·모듈별>/
```

## 스크립트 작성 시
- 원본을 수정하는 스크립트는 **앵커가 1회 매칭되지 않으면 즉시 중단**하도록 작성합니다. 이중 적용을 구조적으로 막습니다. ([F13])
- 검증 스크립트는 **판정 방법과 모집단을 결과에 함께 출력**합니다. 전수와 표본을 구분 표기합니다. ([Step 3])
- 환경적 함정(느린 마운트, 인코딩, 폰트 누락, 경로 특성)은 `context-migration`에 남겨 다음 세션이 재발견하지 않게 합니다.