← ClaudeAtlas

finding-unknownslisted

새 기능·멀티파일·아키텍처 작업의 설계 진입 스킬. 구현 전 unknowns를 털어 리뷰 통과한 스펙(해당 시 프로토타입)을 남긴다. Use when 새 기능, 기능 추가, 설계, 스펙 작성, "~를 만들자/붙이자". 1문장 diff로 설명되는 수정은 대상이 아니다.
HarryJhin/groundwork · ★ 0 · AI & Automation · score 70
Install: claude install-skill HarryJhin/groundwork
# finding-unknowns 요청을 검증된 스펙으로 바꾼다. 사고는 적힌 요구가 아니라 unknowns에서 나온다. 그래서 코드 전에 모르는 것을 턴다. 1문장 diff면 이 스킬을 통째로 생략한다. 산출물은 `docs/specs/SPEC-NNNN-<topic>.md`(4자리 번호, 대응 플랜과 공유). 담을 내용·목차는 아래 「스펙에 담는 것」 절이 정본이다. **주체**: 이 스킬을 로드한 에이전트가 `메인`이자 스펙의 `저자`다. 사용자 왕복이 필요한 일은 그 에이전트가 직접 하고, 조사는 서브에이전트에 넘긴다. 아래에서 `사용자`는 요청한 사람이자 승인자이고, `리뷰��`·`구현자`는 각각 리뷰 스킬과 실행 스킬이 띄우는 서브에이전트다. **경로 기준**: 이 문서의 상대 경로는 두 기준으로 갈린다. `blindspot-prompt.md`처럼 이 스킬이 거느린 파일과 `references/`는 스킬 디렉터리 `${CLAUDE_PLUGIN_ROOT}/skills/finding-unknowns/` 기준이고, `${CLAUDE_PLUGIN_ROOT}`는 groundwork 플러그인이 설치된 디렉터리이지 실행 시점 작업 디렉터리가 아니다. `docs/specs/`처럼 산출물이 놓이는 경로는 사용자 프로젝트 루트 기준이다. ## 산출물 규약 (정본) groundwork flow는 설계에서 종료까지 이어지는 groundwork 스킬의 사슬이고 이 스킬이 그 진입점이다. 이 절이 그 사슬이 남기는 산출물의 경로·명명·번호·커밋 규약 정본이고, 다른 flow 스킬은 여기를 참조한다. | 타입 | 위치 | 명명 | 커밋 | |------|------|------|------| | 스펙 | `docs/specs/` | `SPEC-NNNN-<topic>.md` | ○ | | 플랜 | `docs/plans/` | `PLAN-NNNN-<topic>.md` | ○ | | ADR | `docs/adr/` | `ADR-NNNN-<topic>.md` | ○ | | 프로토타입 | `docs/artifacts/` | `ARTIFACT-NNNN-proto.<ext>` | × | - 번호는 4자리 제로패딩이다. 스펙과 플랜이 같은 번호·`<topic>`을 공유한다(페어). - 프로토타입은 말로 답이 안 나오는 것을 실물로 보여 반응을 받는 산출물이고 커밋하지 않는다. 시각·상호작용이 걸릴 때만 만든다(아래 「기법」과 「게이트」). 대응 스펙의 번호를 공유한다. 스펙과 플랜은 승인받을 때 경로를 제시하지 별도 게재물을 만들지 않는다. - ADR은 번호 축이 다르다. 스펙·플랜·프로토타입이 번호 하나를 공유하는 반면 ADR은 `docs/adr/` 안에서 독립으로 센다. 한 작업이 ADR을 몇 개 남기든 스펙 번호는 줄지 않고, 번호가 겹쳐도 접두가 구분한다. ADR의 위치·명명·번호·커밋·형식·신설 절차 정본은 `groundwork:writing-adr` 스킬이다. - 노트 산출물은 없다. 구현 중 판단은 코드가 스스로 설명하는 세부면 코드 주석으로,