sg-write-docslisted

# Write Diataxis Docs 한 번에 한 주 독자의 한 가지 필요를 해결한다. 네 유형의 문서 세트를 강제로 만들지 말고, 사실 검증, 독자 이해와 독자 경험 설계를 서로 다른 문제로 다룬다. ## 시작 1. 요청이 새 문서 작성, 기존 문서 재구성, 문서 검토, 독자 프로필 작성·갱신·검토 중 무엇인지 확인한다. 검토만 요청받았으면 파일을 수정하지 않는다. 2. 대상 저장소의 기존 문서 구조, 문체, 메타데이터, 링크와 출처 관례, 독자·페르소나 자료를 먼저 확인한다. 3. 코드, 설정, 스키마, 테스트, 제품 자료, 기존 문서와 역공학 산출물 중 사용할 수 있는 원천을 확인한다. 질문으로 확인할 수 있는 사실을 추측하지 않는다. 4. 요청자의 전달 의도와 제약, 재사용 가능한 독자 맥락, 이번 문서의 사용 순간과 결과를 서로 분리한다. 5. 다음 문장으로 문서 계약을 고정한다. ```text 이 문서는 [주 독자 또는 독자 프로필]가 [사용 순간]에 [원하는 변화나 결과]를 얻도록 돕는 [문서 유형]이다. ``` 독자의 주제별 지식 상태, 실행 환경, 잘못 수행했을 때의 위험과 성공 확인 방법도 필요한 만큼 기록한다. 입력이 부족해도 안전하게 진행할 수 있으면 명시적 가정으로 좁히고, 결과를 크게 바꿀 선택만 질문한다. ## 독자 구성 1. 사용자가 지정한 독자와 프로필을 우선하고, 프로젝트의 기존 관례와 `docs/audiences/`를 차례로 확인한다. 2. 독자 자료가 없거나 부족하면 사용자 입력과 저장소의 역할·용어·작업 흐름에서 이번 작업에만 쓰는 임시 가설을 만든다. 이를 확인된 사실로 표현하지 않는다. 3. 주 독자 한 명 또는 역할 집단을 선택한다. 부 독자는 같은 사용 순간과 필요를 공유할 때만 함께 고려하고, 목적·책임·주제별 지식 상태가 충돌하면 문서 분리를 제안한다. 4. 문서에 필요한 목표 지식과 독자의 공통 기반을 대조해 `알고 있음`, `부분 이해`, `오해`, `모름`으로 지식 격차를 좁힌다. 직함이나 단일 숙련도 등급으로 이를 대신하지 않는다. 5. 역할, 반복되는 과업, 공통 기반, 질문, 위험, 환경·접근성 제약 중 작성 결정을 바꾸는 정보만 사용한다. 낯선 개념을 공통 기반으로 설명할 필요가 있을 때만 개념 연결을 설계한다. 6. 프로필과 현재 요청이 다르면 이번 요청을 문서별 조건으로 적용하고 기존 프로필의 갱신 후보를 보고한다. 명시적 요청이나 사용자 확인 없이 프로필을 만들거나 고치지 않는다. 독자 프로필을 작성·갱신·적용·검토하거나 저장 여부를 판단할 때 [독자 모델링 가이드](references/audience-modeling.md)를 읽는다. 프로젝트 관례가 없고 사용자가 저장을 승인하면 [독자 프로필 템플릿](assets/audience-profile-template.md)을 참고해 `docs/audiences/<role-slug>.md`에 사람이 검토할 수 있는 Markdown으로 작성한다. ## 유형 결정 독자가 지금 필요로 하는 것이 행동인지 인지인지,