reportlisted

# Report 스킬 작업 보고서를 프로젝트 `.private/` 디렉터리에 마크다운 파일로 저장한다. 저장 후 프로젝트에 추가 이관 규약(문서 관리 도구 연동 등)이 있으면 그것도 따른다 — 없으면 로컬 저장으로 끝난다. ## 저장 규칙 - **위치 (하드코딩하지 말 것)**: 프로젝트 지침 파일(`AGENTS.md`, `CLAUDE.md` 등)이나 문서 구조가 보고서·산출물 위치를 지정하면 그곳을 쓰고, 없으면 프로젝트 루트의 `.private/`를 기본값으로 쓴다(없으면 생성). 이 문서의 다른 `.private/` 언급은 모두 이렇게 결정된 위치�� 읽는다. - **이미 `private/`(점 없음)를 쓰고 있는 프로젝트라면 그 폴더를 계속 쓴다** — 기본값이 바뀌었다고 새 폴더를 만들면 산출물이 두 곳으로 갈린다. 옮길지는 사용자가 결정한다. - 새로 `.private/`를 만들었으면 프로젝트 `.gitignore`에 `.private/` 항목이 있는지 확인하고, 없으면 추가한다 — 커밋 대상이 아니다. - **파일명**: `<저장위치>/<유형>-<slug>-<YYYYMMDD>.md` - 유형 접두사: `done`(완료보고) · `analysis`(분석) · `decision`(의사결정) - `<slug>`: 보고서 제목에서 영문 소문자 + 하이픈, 40자 이하 (한글 제목은 영문 키워드 추출) - 같은 날 동일 파일명 충돌 시 `-2`, `-3` 접미사 - 예: `.private/done-login-refactor-20260616.md` ## 작업 순서 ### 1. 보고서 유형 결정 argument 또는 대화 맥락에서 유형을 판단한다: - `완료보고`(done) — 작업 완료 후 결과 보고 - `분석`(analysis) — 코드/데이터/이슈 분석 결과 - `의사결정`(decision) — 선택지를 제시하고 사용자 결정 요청 > 구현 계획(작업 시작 전 계획 제안)은 이 스킬이 아니라 `draft-plan`이 담당한다. ### 2. 저장 경로 결정 프로젝트 루트를 판별하고 저장 위치(규약 우선, 없으면 `.private/`)를 준비한다. ```bash ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)" # REPORTDIR = 프로젝트 규약이 지정한 보고서 폴더가 있으면 �� 경로, # 기존 private/(점 없음)가 있으면 그 폴더, 둘 다 없으면 .private/ REPORTDIR="$ROOT/.private" # 규약 위치나 기존 폴더가 있으면 그 절대경로로 바꾼다 mkdir -p "$REPORTDIR" DATE="$(date +%Y%m%d)" ``` 프로젝트명은 아래 우선순위로 결정해 프론트매터·slug에 활용한다: 1. 사용자가 명시한 경우 — 그대로 사용 2. 워킹 디렉토리/레포명 — `basename "$ROOT"` 또는 `git remote get-url origin` 3. 대화 맥락에서 언급