sdd-doc-scaffoldlisted

# SDD 문서 뼈대 생성 빈 골격 문서를 단계별로 만들어 이후 분석과 설계의 틀을 고정한다. 이 Skill은 코드 조사나 실제 내용 작성을 수행하지 않는다. - 등급 판정: [references/task-grading.md](references/task-grading.md) - 문서 관계와 템플릿: [references/document-templates.md](references/document-templates.md) 골격 생성 뒤의 조사와 서술은 별도 Skill을 전제하지 않는다. 같은 에이전트 또는 후속 세션이 일반 작업으로 수행할 수 있다. 사람은 작업 등급, 생성 범위, Stage 완료를 확인하는 게이트 역할을 한다. 이 Skill에 포함된 `references/`는 실행 지침이다. reference를 읽는 것은 프로젝트 조사가 아니며 별도 사용자 확인을 요구하지 않는다. 단, 필요한 시점과 범위는 아래 절차를 따른다. ## 절대 규칙 1. **확정 전에는 파일을 만들지 않는다.** 현재 Stage에서 생성할 파일 목록, 경로, 섹션 헤더, 주요 표 헤더, 문서 관계를 먼저 출력하고 사용자 확인 후에만 저장한다. 일부 항목만 확인했거나 전체 제안 승인인지 모호하면 다시 확인한다. 2. **확인받은 대상 외에는 생성하거나 수정하지 않는다.** 저장소 전체 파일 목록이나 git 상태를 조사하지 않는다. 확인된 생성 예정 경로에 파일이 이미 있으면 덮어쓰지 말고 보고한 뒤 재사용 또는 수정 범위를 다시 확인받는다. 3. **SDD 문서끼리는 반드시 연결한다.** 아직 생성되지 않은 문서는 파일명만 적고 링크하지 않는다. 같은 Stage에서 함께 생성되는 문서는 링크할 수 있다. 4. **입력값과 분석 내용을 보충하기 위해 조사하지 않는다.** 코드, 기존 문서, 저장소 파일 목록, git 상태와 로그에서 값을 추측하지 않는다. 사용자가 제공하지 않은 값은 묻는다. 확인된 생성 예정 경로의 존재 여부와 승인된 SDD 문서의 구조·링크·상태만 필요한 범위로 읽을 수 있다. 5. **TODO 문구는 상수다.** reference 템플릿의 `> TODO:` 문장과 표·목록의 `TODO`를 바꾸거나 실제 내용으로 채우지 않는다. 6. **Stage를 건너뛰지 않는다.** Stage 완료는 파일 존재나 TODO 교체 여부가 아니라 사용자의 명시적인 확인으로만 판정한다. 이전 Stage 완료 확인 전에는 다음 Stage 파일을 제안하거나 만들지 않는다. ## 역할과 완료 기준 | 구간 | 에이전트 | 사람 | |---|---|---| | 작업 시작 | 사용자 설명만으로 등급 후보를 제안한다. | 등급을 확정한다. | | Stage 골격 | 파일 목록, 구조, 관계를 제안하고 확인된 골격만 생성한다. | 생성 범위를 확정한다. | | 내용 작성 | 이 Skill 밖의 일반 작업으로 코드 조사, 분석, 설계를 수행한다. | 결과를 검토하고 Stage 완료를 확인한다. | | 다음 Stage | 이전 Stage 완료 확인 후 다음 골격