---
name: core-solution-documentation
description: 프로젝트 문서 작성·정리·체계화. 문서 전용 서브에이전트와 플랜 서브에이전트 연계, docs 구조·표준·체크리스트
---

# 문서 작성·정리 표준 (Documentation)

Core Solution(MindGarden)에서 **문서를 바탕으로 체계화된 프로젝트**를 유지하기 위한 스킬입니다. 문서 전용 작업 시 이 스킬을 적용하고, **작업 전에는 플랜 서브에이전트와 연계**합니다.

## 문서 전담 원칙 (필수)

- **문서 작업은 문서관리 서브에이전트 전담**이다. 새 문서 작성, 기존 문서 이동·이름 변경·삭제, docs 구조 정리, 인덱스(README) 갱신은 **반드시** 이 스킬을 적용한 서브에이전트(generalPurpose 또는 explore 후 generalPurpose)로 수행한다.
- 다른 에이전트가 코드만 수정할 때 "문서도 업데이트해줘"가 있으면, **문서 수정 부분은 문서관리 규칙에 맞춰 docs 위치를 명시**한 뒤 문서 전담 흐름으로 처리하거나, 동일 태스크 내에서 문서관리 스킬을 적용해 수정한다.
- **문서를 docs/ 밖에 두거나, 위치 체계(standards/design-system/archive/project-management) 없이 두지 않는다.** 찾기 어렵고 예전 문서를 읽고 개발하면 큰일 나므로, **항상 이 위치 체계와 인덱스(docs/README.md)를 따른다.**

## 원칙

- **문서 우선**: 새 기능·표준·변경 사항은 코드/설정과 함께 또는 선행하여 **문서로 정리**한다.
- **한 곳에 정의**: 동일 주제는 **한 표준 문서**에 모으고, 다른 문서는 링크로 참조한다. 중복·분산 지양.
- **최신 유지**: 문서 수정 시 연관 문서(목차, 인덱스, 다른 표준)도 함께 갱신한다.
- **플랜 후 작성**: 넓은 범위의 문서 작업 전에는 **explore(플랜 서브에이전트)**로 현황·누락·우선순위를 조사한 뒤 작성한다.

## 서브에이전트 연계 (플랜 + 문서)

| 단계 | 서브에이전트 | 용도 |
|------|--------------|------|
| **1. 플랜·조사** | **explore** | 문서화할 영역·기존 문서·누락 항목·우선순위 조사. "어디를 문서로 남길지" 목록 산출. |
| **2. 문서 작성·정리** | **generalPurpose** (또는 **core-coder** when only .md) | 조사 결과를 바탕으로 docs 작성·수정·재구성. 이 스킬(/core-solution-documentation) 적용. |

- **작업 전 플랜**: "문서 정리해줘", "표준 문서 만들어줘" 등 요청 시, 먼저 **explore**로 현재 docs 구조·관련 코드·표준 목록을 파악한 뒤, **generalPurpose**로 실제 문서를 작성·수정한다.
- **코드 작업과 병행**: 기능 개발 시 "문서도 업데이트해줘"가 있으면, 코드 수정은 core-coder, **문서 수정은 이 스킬을 적용한 에이전트**로 진행하거나, 한 번에 지시할 때 "문서는 docs/standards/ 어디에 반영"을 명시한다.

## 문서 위치 체계 (docs/)

| 경로 | 용도 |
|------|------|
| **docs/standards/** | **표준·가이드** (API, 코드스타일, 테넌트, 테스트, 배포 등). 최신 표준은 여기. |
| **docs/design-system/** | 디자인 시스템·토큰·컴포넌트 스펙. |
| **docs/archive/** | 과거 버전·폐기 표준. 현재 설계 참조 시 사용 금지. |
| **docs/project-management/** | 프로젝트 관리·리포트·결정 사항. |
| **.cursor/skills/** | **스킬** (에이전트 적용 규칙). 문서 "내용"은 docs/, 스킬은 "어떤 규칙으로 작업할지" 정의. |

- 새 표준 문서는 **docs/standards/** 에 추가. 파일명은 `대문자_스네이크_STANDARD.md` 또는 `*_GUIDE.md` 등 기존 패턴 따름.
- 문서 간 참조는 **상대 경로 또는 문서명**으로 링크. "위치는 docs/standards/XXX.md" 명시.
- **진입점**: 모든 문서 탐색은 **docs/README.md**부터 한다. 새 폴더·문서 추가 시 docs/README.md 목차에 반드시 반영한다.

## 문서 품질 체크리스트

문서 작성·수정 시 아래를 확인한다.

| 항목 | 확인 |
|------|------|
| **제목·개요** | 상단에 제목과 1~2문단 목적·범위 요약 |
| **목차** | 긴 문서는 ## 목차 또는 ## 섹션 헤딩으로 구조 명확히 |
| **일관된 용어** | 프로젝트 용어 통일 (예: tenantId, 테넌트 ID, X-Tenant-Id) |
| **책임·역할** | "누가·어디서" 적용하는지 명시 (예: 필터, 컨트롤러, 스케줄러) |
| **체크리스트·표** | 적용 시 확인할 항목은 표나 리스트로 정리 |
| **참조** | 연관 문서·스킬은 링크 또는 경로 명시 |
| **최신성** | 수정 시 연관 문서(README, 인덱스, 다른 표준) 반영 여부 |

## 스킬과 문서 관계

- **스킬** (`.cursor/skills/*/SKILL.md`): 에이전트가 **작업할 때 따를 규칙** (코드/문서/테스트 유형별 매핑, 금지 사항, 체크리스트).
- **표준 문서** (`docs/standards/*.md`): **사람·에이전트가 참조하는 내용** (API 설계, TenantContext 사용법, 테스트 절차 등).
- 문서를 수정할 때 해당 주제 스킬이 있으면 스킬 내용과 **불일치하지 않도록** 맞춘다. 스킬에 "문서는 docs/standards/TENANT_CONTEXT_USAGE.md 참조"처럼 적혀 있으면 그 문서를 실제 표준으로 유지한다.

## 참조

- 서브에이전트 매핑: `docs/standards/SUBAGENT_USAGE.md`
- 전체 룰·스킬 인덱스: `.cursor/skills/core-solution-rules/SKILL.md`
- 표준 문서 목록: `docs/standards/README.md` (있으면), 및 `docs/standards/` 디렉터리