refactor(specs): migrate SPEC.md to raw/design/specs/ski-NNN-*.md (issue-scoped)

.agents/policies/local-adaptation.md

@@ -77,7 +77,7 @@ uv run sid-reco compile-sid-index --help
 공식 Codex App built-in slash command와는 별개로, enabled skill은 slash 목록에 나타날 수 있다.
 
 - `/docs-manager` 또는 `/doc-manager` — `raw/` source corpus 관리와 `README.md`, `AGENTS.md`, `.github/copilot-instructions.md`, `.agents/policies/local-adaptation.md` 동기화를 포함한 문서 반영 루틴
-- `/spec` — 구현 전에 `SPEC.md`를 정리하는 spec-driven workflow
+- `/spec` — 구현 전에 `raw/design/specs/ski-NNN-*.md`를 정리하는 spec-driven workflow (이슈 단위 1 파일)
 - `/plan` — spec-driven workflow 후속 작업 분해
 - `/build` — incremental-implementation + TDD 기반 구현 흐름
 - `/test` — TDD / Prove-It 기반 검증 흐름
@@ -89,14 +89,14 @@ uv run sid-reco compile-sid-index --help
 
 ## Output Locations
 
-- 스펙: `SPEC.md`
+- 스펙: `raw/design/specs/ski-NNN-*.md` (이슈 단위 1 파일, ADR 네이밍 규약과 동일 패턴)
 - primary graph artifact: `graphify-out/`
 - source corpus: `raw/`
 
 ## Language Conventions
 
 - `raw/design/**` 문서는 한국어로 유지한다.
-- `SPEC.md`, `tasks/plan.md`, `tasks/todo.md`는 신규 작성 또는 의미있는 개정 시 한국어로 작성한다. 기존 영어 내용은 즉시 번역할 의무는 없다.
+- `raw/design/specs/**`, `tasks/plan.md`, `tasks/todo.md`는 신규 작성 또는 의미있는 개정 시 한국어로 작성한다. 기존 영어 내용은 즉시 번역할 의무는 없다.
 
 > graphify orchestration 세부(실행 경로, 커밋 산출물, BUILD_INFO trust signal, hooks auto-refresh 동작 등)는 [`.agents/skills/graphify-manager/SKILL.md`](../.agents/skills/graphify-manager/SKILL.md)를 참조한다.
 

.agents/skills/plan/SKILL.md

@@ -9,7 +9,7 @@ Use the `planning-and-task-breakdown` workflow for this repository.
 
 ## Procedure
 
-1. Read `SPEC.md` if it exists, then inspect the relevant code and docs.
+1. 사용자가 지정한 `raw/design/specs/ski-NNN-*.md`를 먼저 읽는다. 지정이 없으면 `raw/design/specs/` 하위에서 가장 최근 파일을 기준으로 확인한 뒤, 관련 코드와 문서를 검사한다.
 2. Stay in read-only planning mode.
 3. Identify the dependency graph between components.
 4. Slice work vertically (one complete path per task) and draft tasks with acceptance criteria + verification steps.

.agents/skills/spec/SKILL.md

@@ -9,9 +9,9 @@ Use the `spec-driven-development` workflow for this repository.
 
 ## Procedure
 
-1. Read `AGENTS.md`, `README.md`, and `.agents/policies/local-adaptation.md`.
+1. Read `AGENTS.md`, `README.md`, and `.agents/policies/local-adaptation.md`. `raw/design/specs/` 하위 파일명만 스캔해 다음 번호와 기존 패턴을 확인한다 (내용 선탐독 불필요).
 2. Clarify the objective, acceptance criteria, constraints, and boundaries.
-3. Produce a structured `SPEC.md` in the repository root.
+3. 새 spec은 `raw/design/specs/ski-NNN-<slug>.md` 형식으로 생성한다. `NNN`은 3자리 zero-pad된 다음 번호, `<slug>`는 짧은 영어 kebab-case 요약.
 4. Include repository-specific commands such as:
    - `uv run pytest`
    - `uv run ruff check .`

.agents/skills/spec/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
   display_name: "Spec"
   short_description: "Write a structured spec before implementation"
-  default_prompt: "Use $spec to produce a repository-specific SPEC.md before implementation starts."
+  default_prompt: "Use $spec to produce a repository-specific issue-scoped spec under raw/design/specs/ski-NNN-<slug>.md before implementation starts."
 

.agents/skills/using-agent-skills/SKILL.md

@@ -18,7 +18,7 @@ In this repository, the imported skill pack runs with these local rules:
 - Repository-specific command substitutions live in `.agents/policies/local-adaptation.md`.
 - Primary verification commands are `uv run pytest`, `uv run ruff check .`, `uv run mypy src`, and `uv run sid-reco doctor`.
 - Shared checklists live in `.agents/playbooks/`.
-- Idea artifacts belong in `ideas/`; spec/task artifacts belong in `SPEC.md` and `tasks/`.
+- Idea artifacts belong in `ideas/`; spec artifacts belong in `raw/design/specs/ski-NNN-*.md`; task artifacts belong in `tasks/`.
 
 ## Skill Discovery
 

README.ko.md

@@ -342,7 +342,7 @@ source corpus:
 - `raw/design/`
 - `raw/external/`
 
-Graphify 입력에는 `.agents/`, `README*`, `SPEC.md`, `CLAUDE.md`/`AGENTS.md`가 포함되지 않는다.
+Graphify 입력에는 `.agents/`, `README*`, `CLAUDE.md`/`AGENTS.md`가 포함되지 않는다. 이슈 단위 스펙은 `raw/design/specs/ski-NNN-*.md`에 두고 source corpus의 일부로 취급한다.
 
 ## Copilot 및 Agent 하네스
 

README.md

@@ -384,7 +384,7 @@ Source corpus:
 - `raw/design/`
 - `raw/external/`
 
-Graphify does not treat `.agents/`, `README*`, `SPEC.md`, or `CLAUDE.md`/`AGENTS.md` as source input.
+Graphify does not treat `.agents/`, `README*`, or `CLAUDE.md`/`AGENTS.md` as source input. Issue-scoped specs under `raw/design/specs/ski-NNN-*.md` are part of the source corpus.
 
 ## Copilot and Agent Harness