아이디어 다듬기 스킬
목적
구조화된 질문을 통해 기능 아이디어를 명확히 하고 정제합니다. 이 과정은 공식 컨셉 문서를 작성하기 전에 모호성, 엣지 케이스, 디자인 고려 사항을 발견하는 데 도움을 줍니다.
사용 시기
- 사용자가 대략적인 기능 아이디어를 가지고 있지만 완전히 정립되지 않았을 때
- 컨셉 문서를 작성하기 전
- 기능 아이디어에 더 명확성이 필요할 때
- 디자인 공간과 트레이드오프를 탐색할 때
전제 조건
- 사용자가 대략적인 기능 아이디어를 설명함
- 기능 번호와 이름이 결정되었거나 결정될 예정임
절차
1. 기능 번호와 이름 결정
아직 결정되지 않은 경우:
ls -1d ./docs/features/[0-9][0-9][0-9][0-9]-* 2>/dev/null | tail -1
사용자와 협의하여 다음 번호와 설명적인 이름을 선택합니다.
2. 계획 디렉토리 생성
mkdir -p ./planning/NNNN-기능-이름
3. 아이디어 다듬기 문서 초기화
cat > ./planning/NNNN-기능-이름/idea-honing.md << 'EOF'
# 아이디어 다듬기: 기능 이름
## 초기 아이디어
[사용자의 기능에 대한 대략적인 설명]
## 질문과 답변
EOF
4. 초기 질문 생성
사용자의 대략적인 아이디어를 바탕으로 모호성을 식별하고 다음에 대한 질문을 생성합니다:
- 사용 사례 및 사용자 워크플로우
- 범위와 경계
- 통합 지점
- 엣지 케이스
- 트레이드오프와 제약 조건
- 성공 기준
탐색할 질문 목록을 만듭니다.
5. 한 번에 하나씩 질문하기
중요: 한 번에 하나의 질문만 하십시오.
각 질문에 대해:
- 질문을 명확히 제시합니다.
- 사용자의 답변을 기다립니다.
- 필요하면 답변에 대해 논의하고 정제합니다.
- 만족스러우면 Q&A를 문서에 기록합니다.
- 새로운 모호성이 발견되면 질문 목록에 추가합니다.
- 다음 질문으로 넘어갑니다.
6. 각 Q&A 후 문서 업데이트
각 질문에 답변한 후 문서에 추가합니다:
cat >> ./planning/NNNN-기능-이름/idea-honing.md << 'EOF'
### Q: [질문 내용]
**A**: [답변 내용]
EOF
7. 프로세스 발전시키기
질문을 진행하면서:
- 새로운 모호성이 나타날 수 있음 – 이를 새 질문으로 추가합니다.
- 일부 질문은 관련이 없어질 수 있음 – 건너뜁니다.
- 프로세스는 유기적으로 스스로 발전합니다.
질문이 기존 코드 동작에 관한 것인 경우(예: "오늘날 X는 어떻게 작동하나요?"):
- 조사가 필요함을 기록합니다.
- 다른 질문을 계속 진행합니다.
- 이러한 질문은 후속 조사에서 처리됩니다.
8. 명확해지면 종료
기능 아이디어가 충분히 명확해지면:
- 주요 인사이트를 요약합니다.
- 사용자에게 컨셉 작성을 준비할 준비가 되었는지 확인합니다.
- 아이디어 다듬기 문서는 참조를 위해
planning/디렉토리에 남습니다.
검증
아이디어 다듬기 문서를 확인합니다:
# 문서 존재 확인
ls ./planning/NNNN-기능-이름/idea-honing.md
# 내용 검토
cat ./planning/NNNN-기능-이름/idea-honing.md
일반적인 문제
한 번에 여러 질문하기: 한 번에 하나의 질문만 하십시오. 이렇게 하면 집중을 유지하고 더 깊이 탐색할 수 있습니다.
답변을 기록하지 않음: 각 질문에 답변한 후 즉시 문서를 업데이트하십시오. 일괄 처리하지 마십시오.
너무 일찍 중단하기: 사용자가 기능 범위와 접근 방식에 대해 확신을 가질 때까지 계속 진행하십시오.
다음 단계
아이디어 다듬기 후:
propose-feature-concept스킬을 사용하여 공식 컨셉을 작성합니다.- 컨셉을 작성할 때 아이디어 다듬기 문서를 참조합니다.
- Q&A는 컨셉의 서사에 자료를 제공합니다.