메뉴
기획 문서(plan.md 등) 또는 아키텍처 문서(architecture.md 등)를 harness-boot 의 `.harness/spec.yaml` (v2.3.8 스키마)로 변환할 때 사용. 사용자가 "기획을 스펙으로", "plan.md를 spec.yaml로", "설계문서 변환", "스펙 채우기" 등을 요청하는 경우 트리거. 변환은 정보 손실을 최소화하고 🔒 구조 / 🗒 자유텍스트 경계를 엄격히 준수하며, 담을 수 없는 덩어리는 `unrepresentable.md` 로 분리한다. 도메인별 세부 체크는 `adapters/` 하위의 도메인 어댑터로 위임.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | spec-conversion |
| description | 기획 문서(plan.md 등) 또는 아키텍처 문서(architecture.md 등)를 harness-boot 의 `.harness/spec.yaml` (v2.3.8 스키마)로 변환할 때 사용. 사용자가 "기획을 스펙으로", "plan.md를 spec.yaml로", "설계문서 변환", "스펙 채우기" 등을 요청하는 경우 트리거. 변환은 정보 손실을 최소화하고 🔒 구조 / 🗒 자유텍스트 경계를 엄격히 준수하며, 담을 수 없는 덩어리는 `unrepresentable.md` 로 분리한다. 도메인별 세부 체크는 `adapters/` 하위의 도메인 어댑터로 위임. |
| version | 0.5 |
v0.5 는 Phase 2.13 (v2.3.8 스키마 승격 · metadata.extensions.* → metadata.*) 이후의 네이티브 전환 판이다:
command_map / ambient_files / host_binding / drift_catalog / versioning_axes / contribution_points / preamble_contract / changelog / gate_chain)을 metadata.* 에 직접 작성. 생성 시 metadata.extensions.* 경유 금지.agent_permissions 는 여전히 metadata.extensions.agent_permissions (v2.4.0 스키마 대기).docs/schemas/spec.schema.json 로 validate + scripts/conversion_diff.py --all 로 시맨틱 회귀.metadata.extensions.* 입력을 만나면 scripts/upgrade_to_2_3_8.py 호출 후 진행.v0.4 (Phase 2.82.13) 자산 계승 — 원칙 24개(P-1P-24), 어댑터 5종(cli/worker/saas/game/library v0.1/meta v0.2), 8 샘플 골든, v2.3.8 JSONSchema 및 마이그레이션 스크립트.
v0.3 에서 계승된 자산:
관련 지식 자산:
design/samples/{url-shortener,retro-jumper,price-crawler,vapt-apk-sast,tzcalc,harness-boot-self,vite-bundle-budget,vscode-commit-craft}/ — meta 3-샘플은 {...}/v2/ 에 v2.3.8 네이티브 산출물 (★★★+ 88~94%)harness-boot-self/unrepresentable.md §4 (누적 G-01vite-bundle-budget/unrepresentable.md §3 (NEW-35) + vscode-commit-craft/unrepresentable.md §3 (NEW-36 — 총 36종) + {...}/v2/unrepresentable-v2.md 재변환 기준 해소/잔여 판정design/samples/PHASE1-REVIEW.mddesign/samples/META-RECONVERSION-COMPARE.md (3 subtype fingerprint + F-1~F-8 HIT)skills/spec-conversion/adapters/{worker,saas,game,library v0.1,meta v0.2}.mdskills/spec-conversion/templates/backlink-matrix.mdtests/regression/conversion-goldens/ (8 샘플, 8/8 PASS) — v2 재변환본은 별 트랙scripts/conversion_diff.pydocs/schemas/spec.schema.json (draft 2020-12, 9 $defs, 11/11 validate)scripts/upgrade_to_2_3_8.py (ruamel round-trip, --dry-run/--no-backup)design/rfcs/v2.3.8-metadata-extensions-promotion.mddesign/rfcs/v2.4.0-schema-expansion.md (agent_permissions + 잔여 P2).harness/spec.yaml 이 비었거나 metadata.source.origin: planning_doc|architecture_doc|existing_code 프로젝트에서 /harness:spec Mode B 실행/harness-boot:init 옵션 3 (이미 코드가 있는 프로젝트) 라우팅 — existing_code 진입점은 adapters/brownfield.md 로 위임 (F-036)@spec-conversion 호출정찰 전에 먼저 이 문서가 무엇인가 를 판정:
project.vision 과 BR.rationale 에 반드시 반영문서 전체를 훑으며 섹션별로 매핑 후보만 나열. YAML 한 줄도 쓰지 않는다.
정찰 시 주의할 신호들:
정찰 결과를 토대로 우선순위 순으로 YAML 작성:
project → domain (의미 결정력 높은 블록)features (skeleton 우선)constraints / deliverablemetadata.source.source_lines (최소 엔티티·피처 1건씩)작성 중 자리 없는 덩어리를 만나면 즉시 unrepresentable.md 섹션에 1줄 기록(상세 기술은 Stage 3).
unrepresentable.md: 갭 카탈로그 (ID·인용·제안 스키마·임시 대응 품질
점수(P-22) 필수)conversion-notes.md: 망설임·결정 로그 (skill 개선 재료)templates/backlink-matrix.md 기반으로 원본의 모든 섹션이 산출물 중
하나로 갔는지 확인:
Stage 4 검증을 통과한 시점에서 spec.yaml 은 충분히 성숙하므로,
파생 뷰(.harness/domain.md · .harness/architecture.yaml) 를
즉시 materialize 한다. 이로써 변환 직후 /harness-boot:work 첫 사이클
이 sync 를 별도로 트리거할 필요가 없어지고, kickoff 템플릿이
domain.md 를 참조할 때 파일이 이미 존재한다.
python3 "$PLUGIN_ROOT/scripts/sync.py" --harness-dir "$(pwd)/.harness" --soft
--soft 는 fail-open: 변환 결과가 어떤 이유로든 schema 검증을
통과하지 못해도 sync (initial): fail — <reason> 한 줄 찍고
exit 0. 사용자는 conversion-notes 에 원인을 기록하고 다음
변환 사이클에서 보강한다.sync (initial): ok — synced 가 찍히고
domain.md · architecture.yaml · harness.yaml.generation.generated_from.spec_hash
가 한꺼번에 갱신된다. 이 결과는 §7 산출물 enumeration 의
파생 항목에 포함된다.자유 텍스트 필드 (description: · risks[].statement: ·
business_rules[].statement: · acceptance_criteria[]) 가 wrap 된
plain scalar 로 emit 되면 continuation line 의 첫 문자가 { 이거나
줄 안에 : 가 있을 때 YAML 파서가 nested mapping 으로 오인하고
harness sync / harness validate 가 즉시 PARSE 실패로 abort 한다.
검증 단계에서 retroactive 하게 잡을 수 없다 — 파싱이 먼저 깨지기 때문.
fix 는 emit 측에 있다.
규칙 (Write tool 로 spec.yaml 작성 시):
description: (project · features · constraints 등) → |-
literal block scalar 강제. 줄바꿈 보존 + flow indicator 영향 0.risks[].statement: · business_rules[].statement: → 한 줄이면
"..." double-quoted, 여러 줄이면 |-. 백틱 (``) · CSS
{...} · JS ${template} · transform: translateY(...) 같이 코드
냄새 나는 본문이 들어갈 때 plain scalar 절대 금지.acceptance_criteria[] · open_questions[].options[] → 각 entry
"..." double-quoted. 한 줄이 고유 의미인 필드라 quote 가 가장
안전.확신 안 서면 |- 또는 "..." 중 하나. plain scalar 는 짧고
영문/숫자만 있을 때만.
태그 의미: MUST = 위반 시 스펙 붕괴 / SHOULD = 도메인 독립적 권장 / MAY = 도메인 특수적
| # | 태그 | 원칙 | 한 줄 요약 | 메트릭 |
|---|---|---|---|---|
| P-1 | MUST | 4단계 변환 | Stage 0/1/2/3/4 분리, 정찰에서 타협 금지 | stages_completed / 5 |
| P-2 | MUST | 자리 없는 덩어리는 unrepresentable.md | 억지 매핑 금지 | gaps_recorded / gaps_encountered |
| P-3 | MUST | 모호 표현을 AC 로 옮기지 않음 | "~면 좋음" → open_questions | ambiguous_in_ac_ratio (목표 ≤ 5%) |
| P-4 | SHOULD | 엔티티 필드 점검 의무 | entity 정의 직후 필드 목록 탐색 | fields_captured / fields_in_source |
| P-5 | SHOULD | modules 에서 external deps 추출 | 벤더성 이름 → 인벤토리 | deps_extracted / vendor_hints |
| P-6 | MUST | 미결정을 결정으로 표현 금지 | 확신 없으면 open_question | open_q_preserved / open_q_in_source |
| # | 태그 | 원칙 | 한 줄 요약 | 메트릭 |
|---|---|---|---|---|
| P-7 | SHOULD | 비목표 카탈로그 분리 | "v1 범위 밖" → non_goals | non_goals_captured / declared |
| P-8 | SHOULD | 수치 상수를 AC 에서 분리 | k·delta·timer 는 tuning_constants | ac_with_numeric_ratio (목표 ≤ 10%) |
| P-9 | MAY | prototype_mode 활성 조건 | 기간 ≤4주 + 데모 목적 + coverage<70 중 2개 | 조건 2개 충족 여부 bool |
| P-10 | SHOULD | deliverable.type 과 platform 분리 | 정체성 소실 케이스 기록 | 소실 감지 bool (수동 검토) |
| P-11 | MAY | 에셋 매니페스트 후보 분리 | 스프라이트·오디오 등 | assets_recorded / mentions |
| P-12 | SHOULD | 외부 의존성 인벤토리 워크플로 | modules 직후 벤더 추출 | external_deps_coverage |
| P-13 | SHOULD | 실패 정책을 BR 에 섞지 않음 | retry/backoff/DLQ → failure_policies | failure_policy_in_br_count (목표 0) |
| P-14 | MAY | 스케줄·동시성·속도 제한 전용 후보 | cron·concurrency → entry_points 확장 | worker/job 도메인에서 schedule_captured |
| # | 태그 | 원칙 | 한 줄 요약 | 메트릭 |
|---|---|---|---|---|
| P-15 | MUST | 구조적 안전 불변식은 BR 과 분리 | "LLM 호출 금지"·"ScanDB 만 통신" 류는 project.invariants[] 또는 unrepresentable 의 safety_constraints | 분리 여부 bool |
| P-16 | SHOULD | 문서 성숙도 축 분기 | planning vs architecture vs implementation — 변환 전략 다름 | metadata.source.maturity 기입 여부 |
| P-17 | SHOULD | 모듈 계층(tool/skill/agent) 인지 | AI 에이전트 제품은 각 module 에 layer 속성 후보 | modules_with_layer_hint / total |
| P-18 | SHOULD | 실행 DAG 는 features 평면이 아닌 별도 | DAG·orchestrator·상태머신 언급 시 unrepresentable 에 execution.dag 후보 | DAG 언급 시 엔트리 존재 bool |
| P-19 | MUST | LLM agent 변환 시 과잉 발동 방지 | agent 는 P-6 가 과해지고 P-4 가 덜 되는 경향 — prompt 로 카운트 강제 | agent-mode 시 entity_field 미나열 시 재시도 |
| P-20 | SHOULD | 요금제·티어·쿼터는 구조 보존 | "Free/Pro/Enterprise"는 stakeholder.concerns 로 축소 금지 | 요금제 언급 시 NEW-20 엔트리 존재 |
| P-21 | SHOULD | 저자 강조 축 선제 식별 | Stage 0 에서 핵심 주장 3개 → project.vision + BR.rationale 필수 반영 | vision 길이 + BR.rationale 비어있지 않은 비율 |
| # | 태그 | 원칙 | 한 줄 요약 | 메트릭 |
|---|---|---|---|---|
| P-22 | SHOULD | 자기참조 스펙의 self-consistency 체크 | 스펙이 자기 BR 을 스스로 지키는지 변환 말미에 1회 훑어봄 | self_ref_br_checked / total_br (자기참조 스펙일 때만) |
| P-23 | SHOULD | CLI/플러그인에서 features 와 entry_points 중복 허용 | meta 도메인에서는 같은 명령이 양쪽에 나타남 — command_map 도입 전까지 중복 감수 | 중복 의도 명시 bool (conversion-notes) |
| P-24 | MAY | 변경 이력 metadata 보존 | architecture 성숙도 + 부록 changelog 가 있으면 metadata.changelog[] 또는 $include 권장 | changelog 언급 시 metadata 기입 bool |
참고: P-22 는 meta 도메인에서 self_reference=true 샘플에만 MUST, 그 외 (vite-bb / vscode-cc 등 host-plugin) 는 N/A (adapters/meta.md v0.2 §5.1 F-7 조건부).
| # | 트리거 | 맵핑 대상 |
|---|---|---|
| H-1 | 단락형 서술 | 🗒 description/overview (5줄 이상 $include 고려) |
| H-2 | 정책·규칙 서술 | domain.business_rules[] (statement + rationale 분리) |
| H-3 | 기능 bullet | features[].acceptance_criteria[] (bullet 1 = AC 1) |
| H-4 | 타겟 사용자·이해관계자 | project.stakeholders[] (end-user 제외) |
| H-5 | 엔티티 정의 | domain.entities[] (3~7개, sensitive 판정 포함) |
| H-6 | 기술 스택 | constraints.tech_stack (결정값만, 이유는 ADR) |
| H-7 | 스켈레톤 | features[0].type=skeleton, AC 는 최소 왕복만 |
| H-8 | 공개 API 심볼 (library) | unrepresentable → public_api[] 후보 |
| H-9 | 벤치마크·Ground Truth | unrepresentable → benchmarks (NEW-22) |
| H-10 (v0.6) | plan.md ## Trade-off ADRs 섹션 | decisions[] (id=ADR-NNN, context/decision/consequences 분리, tags[] 필수 — security/ui/stack/perf/data 등) |
| H-11 (v0.6) | plan.md ## Risks 섹션 | risks[] (id=R-NNN, likelihood/impact enum {low,medium,high}, mitigation 필수, tags[] 권장) |
| H-12 (v0.6) | ADR 의 "대체" 언급 (supersedes, "old-xyz 는 더 이상") | decisions[].supersedes[] 에 이전 ADR id 배열. 대체된 ADR 는 status=superseded 로 자동 전이 · superseded_by 로 역참조 |
| H-13 (v0.6) | plan.md 의 "성능 예산·appetite·LCP/INP/p95" | features[].performance_budget (lcp_ms/inp_ms/cls/bundle_kb/latency_p95_ms/memory_rss_mb). 수치 없으면 omit — unrepresentable 금지. |
| # | 실수 | 올바른 처리 |
|---|---|---|
| X-1 | 미결정 이슈를 AC로 봉인 | open_questions[] (스키마 없으면 unrepresentable) |
| X-2 | p95·FPS·가용성을 AC 자연어로 흘림 | non_functional (G-01) |
| X-3 | Entity 필드를 invariants 에 뭉개기 | entities[].attributes[] (또는 unrepresentable) |
| X-4 | 벤더를 modules 이름으로만 | external_dependencies[] (G-06) |
| X-5 | 역할이 plan.md 명시 안 됐다고 stakeholder 누락 | concerns 로 등재 (법무·DevOps 포함) |
| X-6 | bullet 여러 개를 AC 1개로 병합 | bullet 당 1 AC 가 기본 |
| X-7 | 같은 기능을 features/BR 중복 | features="동작", BR="정책" |
| X-8 | 재시도 정책을 BR 에 섞기 | failure_policies 별도 (P-13) |
| X-9 | 수치 튜닝값을 AC 에 녹이기 | tuning_constants 별도 (P-8) |
| X-10 | "비목표"를 vision 한 줄에 처박기 | non_goals 카탈로그 (P-7) |
| X-11 | 스케줄·concurrency 를 BR 에만 | entry_points.schedule 후보 (P-14) |
| X-12 | 요금제를 stakeholder.concerns 로 축소 | NEW-20 pricing.plans 구조 보존 (P-20) |
| X-13 | LLM agent 가 모든 미결을 open_questions 로 몰기 | P-19 과잉 발동 감지 — 결정 가능한 건 결정 |
| X-14 | 아키텍처 문서를 planning 처럼 접근해 결정 rationale 손실 | P-16 성숙도 분기 + BR.rationale 적극 사용 |
| X-15 | 자기참조 스펙에서 자기 BR 을 자기가 지키는지 확인 안 함 | P-22 self-consistency 체크 (meta 도메인) |
| X-16 | CLI 플러그인에서 features/entry_points 중복을 "오류"로 보고 억지 병합 | P-23 의도적 중복 허용, command_map 도입 대기 |
| X-17 | 부록 changelog 를 description 에 녹이려다 metadata 탈락 | P-24 metadata.changelog[] 또는 $include |
docs/spec/, .harness/spec/ 하위features[0].type == skeleton 이며 AC 가 최소 왕복만 (P-1, R-1)## Trade-off ADRs → decisions[] (H-10) · ## Risks → risks[] (H-11) — v0.6 부터 unrepresentable 경로 금지, 반드시 구조화 필드로 변환.safety_constraints/invariants 로 분리됨 (P-15)metadata.source.maturity 기입 (P-16)backlink-matrix.md 작성 완료.harness/spec.yaml — 주 산출물docs/spec/unrepresentable.md — 갭 카탈로그 (갭 0 이라도 파일은 존재)docs/spec/conversion-notes.md — 의사결정 로그docs/spec/backlink-matrix.md — Stage 4 검증 (v0.3 신규 필수)docs/spec/<field>.md — $include 로 분리한 자유텍스트Stage 5 파생 (F-076 — --soft sync 가 ok 일 때 자동 생성):
.harness/domain.md — entities + business_rules → prose 뷰.harness/architecture.yaml — adapters + constraints → 머신 친화 뷰harness.yaml.generation.generated_from.spec_hash 도 함께 갱신되어
이후 /harness-boot:work 사이클이 drift 검사를 정상 수행할 수 있다.
핵심 원칙만 이 SKILL.md 에 두고, 도메인 특수 체크는 어댑터로 위임:
| 어댑터 | 시그널 | 우선 갭 |
|---|---|---|
adapters/worker.md | cron·큐·ETL | G-14/15/16/06/12 |
adapters/saas.md | React·요금제·SSO | NEW-20·G-02·G-04·NEW-19 |
adapters/game.md | FPS·스프라이트·게임루프 | G-11/12/13·P-10 |
adapters/library.md v0.1 | SDK·semver·패키지 | NEW-24·G-08·NEW-25·NEW-26·NEW-27 |
adapters/meta.md v0.2 | 플러그인·CLI·slash command·devtool·에디터확장 (self-bootstrap + host-plugin 2형, host-plugin 은 빌드도구·에디터확장 2서브타입) | NEW-28·NEW-33·NEW-30·NEW-29·NEW-34·NEW-35 host_binding·NEW-36 contribution_points |
adapters/brownfield.md v0.1 (F-036) | 입력 형태 어댑터 — 기존 코드 (manifest 1+ · .harness/spec.yaml 부재 · existing_code origin) | 결정론 정찰(scripts/scan/*) 우선 · LLM 은 overview/entities/BR/ADR 만 · _seed_status: draft 마커 |
로딩 규칙: Stage 0 에서 도메인 판정 후 해당 어댑터를 Read. 복수 도메인이 해당되면 모두 로드 (예: VAPT = saas + security). brownfield 는 입력 형태 어댑터이므로 도메인 어댑터와 직교 — 항상 합성 가능.
축 1 — 시맨틱 (불변성):
tests/regression/conversion-goldens/{sample}/python3 scripts/conversion_diff.py --all축 2 — 스키마 (v2.3.8 네이티브 준수):
docs/schemas/spec.schema.json (draft 2020-12)metadata.extensions.* 가 출력에 남아있으면 reviewer 가 수동 플래그 (skill 위반)승격 조건: skill 버전업 머지 전 두 축 모두 PASS. scripts/upgrade_to_2_3_8.py --dry-run 로 입력 샘플 pre-flight 가능.
agents/spec-converter.md 승격. /harness:spec Mode B 가 자동 호출.harness/events.log 의 spec_conversion_corrected 이벤트 정의/harness:spec --learn 사용자 수정 학습| ID | 필드 | 등급 | 위치 |
|---|---|---|---|
| NEW-28 | command_map[] | P0 | metadata.command_map (최상위 승격) |
| NEW-33 | ambient_files[] | P0 | metadata.ambient_files |
| NEW-35 | host_binding | P0 (host-plugin 조건부) | metadata.host_binding |
| NEW-31 | drift_catalog[] | P0 | metadata.drift_catalog |
| NEW-32 | versioning_axes[] | P0 | metadata.versioning_axes |
| NEW-36 | contribution_points[] | P1 (editor-extension 서브타입) | metadata.contribution_points |
| NEW-34 | preamble_contract | P1 | metadata.preamble_contract |
| P-24 | changelog[] | P1 (MAY) | metadata.changelog |
| NEW-30 | gate_chain[] | P2 (MAY · anyOf 2 스타일) | metadata.gate_chain |
작성 규칙 (v0.5 MUST): 생성 시 위치는 metadata.* 직접. metadata.extensions.* 경유는 deprecated (입력에선 허용, 출력에선 금지).
metadata.extensions.* 유지)| ID | 필드 | 상태 | 메모 |
|---|---|---|---|
| NEW-29 | agent_permissions[] | extensions 잔존 | v2.4.0 에이전트 12종 매트릭스와 함께 승격 예정 |
| ID | 제안 필드 | 재현 샘플 | 등급 |
|---|---|---|---|
| NEW-24 | public_api[] | tzcalc + self | P0 |
| G-01 | non_functional | 6/6 | P1 |
| G-10 | open_questions[] | 6/6 | P1 (최상위 이미 사용 중) |
| G-13 | non_goals[] | 5/6 | P1 |
| NEW-25 | compatibility_matrix | tzcalc + self | P1 |
| NEW-26 | deliverable.artifacts[] | tzcalc + self | P1 |
| NEW-17~23, 27 | 도메인 특수 | 각 1/6 | P2 |
| G-04/07/08/09/11/12/14/15/16 | (각 blocks) | 이월 | P2 |
자세한 RFC: design/rfcs/v2.4.0-schema-expansion.md
self_reference=true 조건부로 명확화, F-9(Config 엔티티 분리) 가설 HIT 확정. 회귀 7/7 PASS 유지.metadata.extensions.* 네임스페이스 9 블록 실장 (command_map·ambient_files·host_binding·agent_permissions·gate_chain·drift_catalog·versioning_axes·preamble_contract·contribution_points), top-level open_questions[] 11 엔트리 + metadata.changelog[] 6 엔트리 추가. ★★★+ 65% → 94% (17-기준) / 100% (rated) — 사용자 목표 ≥90% 달성. NEW-28~34 전수 해소 확인. v2.3.8-rfc 승격 후보 4건 식별 (command_map / gate_chain / drift_catalog / preamble_contract). 회귀 분류: v1 골든 8/8 PASS 유지, v2 는 harness-boot-self/v2/ 에 별도 산출물로 등록. 관찰: 자기참조 샘플은 미래 schema RFC 의 candidate fields 증거 수집 용도로 작동 (P-25 후보 씨앗).metadata.extensions.* 9-블록 패턴을 vite-bundle-budget v2 (host-plugin/build-tool) + vscode-commit-craft v2 (host-plugin/editor-extension) 에 교차 적용. 둘 다 7 블록 실장, ★★★+ 65% → 88% (17-기준) / 94% (rated) 3/3 샘플에서 재현. vscode-cc v2 에서 NEW-36 contribution_points 7 kind 전수 실현 (command/keybinding/view/configuration/menus/statusbar/activationEvents) — editor-extension subtype 의 distinctive 특성 실증. 서브타입 지문 확정: self-bootstrap BR/F=0.67 + preamble.required=true, host-plugin build-tool BR/F=1.0 + peer_contract, host-plugin editor-extension BR/F=1.0 + publisher_contract. MANIFEST.yaml 의 re_conversions: 1→3, host_subtype 필드 추가. design/samples/META-RECONVERSION-COMPARE.md (3 샘플 지문 매트릭스 + F-8 가설 3/3 완전 실현 + v2.3.8 승격 스코어카드) 산출.design/rfcs/v2.3.8-metadata-extensions-promotion.md 저작. 9 블록 등급 판정: command_map/ambient_files/drift_catalog/versioning_axes P0 MUST-if-present (3/3 HIT), host_binding P0 SHOULD 서브타입 조건부 (2/2 host-plugin), contribution_points P1 SHOULD 서브타입 인식, preamble_contract P1 MAY, changelog P2 MAY, gate_chain P1 MAY (조건부 — self-bootstrap full, host-plugin 은 drift_catalog.action 흡수 허용). metadata.extensions.* 네임스페이스는 deprecated (v2.5.0 제거 예정).docs/schemas/spec.schema.json v2.3.8 작성 (8 블록 + gate_chain $defs, 11/11 샘플 validate). scripts/upgrade_to_2_3_8.py 마이그레이션 스크립트 구현 (ruamel.yaml round-trip 으로 주석·순서 보존, --dry-run / --no-backup 지원). 3 v2 샘플 metadata.extensions.* → metadata.* 이관 완료 (self-v2: 8 블록 이관 + agent_permissions 유지 [v2.4.0 대기], vite-bb/vscode-cc: 7 블록 이관 + extensions 네임스페이스 완전 제거). conversion_diff 회귀 8/8 PASS + JSONSchema 검증 11/11 OK. v2.3.8 승격 조건 충족 상태.templates/ 에 3종 신설 — spec-skeleton-v2.3.8.yaml (metadata.* 직접 배치 모범, extensions 경유 금지 주석), unrepresentable.md (v2.3.8 승격 완료 필드 목록 + 재변환 라운드 판정 표), conversion-notes.md (가설/개선 후보/회귀 체크 6-섹션 표준형). 회귀 11/11 schema OK + 8/8 semantic PASS 재확인.adapters/brownfield.md v0.1). /harness-boot:init 옵션 3 (이미 코드가 있는 프로젝트) 진입로. 결정론 정찰 (scripts/scan/{manifest,structure,seed_spec}) 우선 + LLM 은 domain.{overview,entities[]} 만 시드. _seed_status: draft 마커 + skip 시 옵션 1 동치 (starter template byte-equal). §0 트리거에 existing_code origin enum 추가, §8 어댑터 표에 brownfield 한 줄 (입력 형태 어댑터 — 도메인 어댑터와 직교).