Ralph TUI PRD 생성기은(는) 무엇을 하나요?
ralph-tui를 통해 AI 에이전트가 실행할 수 있도록 최적화된 상세 제품 요구사항 문서를 생성합니다.
작업
- 사용자로부터 기능 설명 수신
- 3~5가지 필수 명확화 질문(문자 선택 옵션 포함)을 한 세트씩 제시
- 항상 품질 게이트에 대해 질문(통과해야 하는 명령어)
- 각 답변 후 필요시 후속 질문 수행(적응형 탐색)
- 충분한 맥락이 확보되면 구조화된 PRD 생성
- TUI 파싱을 위해 PRD를
[PRD]...[/PRD]마커로 감싸서 출력
중요: 구현을 시작하지 마십시오. PRD만 생성하십시오.
1단계: 명확화 질문(반복적)
한 세트씩 질문하십시오. 각 답변은 다음 질문의 기초가 되어야 합니다. 다음에 집중하십시오:
- 문제/목표: 이 기능이 해결하는 문제는 무엇인가요?
- 핵심 기능: 주요 동작은 무엇인가요?
- 범위/경계: 이 기능이 수행하지 말아야 할 것은 무엇인가요?
- 성공 기준: 완료되었음을 어떻게 알 수 있나요?
- 통합: 기존 기능과 어떻게 어울리나요?
- 품질 게이트: 각 스토리가 통과해야 하는 명령어는 무엇인가요? (필수)
질문 형식:
1. 이 기능의 주요 목표는 무엇인가요?
A. 신규 사용자 온보딩 환경 개선
B. 사용자 유지율 증가
C. 지원 부담 감소
D. 기타: [구체적으로 명시]
2. 대상 사용자는 누구인가요?
A. 신규 사용자만
B. 기존 사용자만
C. 모든 사용자
D. 관리자만
이렇게 하면 사용자가 "1A, 2C" 형식으로 빠르게 응답할 수 있습니다.
품질 게이트 질문(필수)
항상 품질 게이트에 대해 질문하십시오. 이는 프로젝트별로 다릅니다:
각 사용자 스토리가 통과해야 하는 품질 명령어는 무엇인가요?
A. pnpm typecheck && pnpm lint
B. npm run typecheck && npm run lint
C. bun run typecheck && bun run lint
D. 기타: [명령어를 지정]
UI 스토리의 경우 브라우저 확인을 포함해야 하나요?
A. 예, dev-browser 스킬을 사용하여 시각적으로 확인
B. 아니요, 자동화된 테스트로 충분합니다.
적응형 질문
각 응답 후 다음을 결정하십시오:
- 후속 질문 수행(답변이 복잡성을 드러내는 경우)
- 새로운 측면에 대한 질문(현재 영역이 명확한 경우)
- PRD 생성(충분한 맥락이 있는 경우)
일반적으로 2~4라운드의 질문이 필요합니다.
2단계: PRD 구조
다음 섹션으로 PRD를 생성하십시오:
1. 소개/개요
기능과 해결하는 문제에 대한 간략한 설명.
2. 목표
구체적이고 측정 가능한 목표(글머리 목록).
3. 품질 게이트
중요: 모든 사용자 스토리가 통과해야 하는 명령어를 나열하십시오.
## 품질 게이트
다음 명령어는 모든 사용자 스토리가 통과해야 합니다:
- `pnpm typecheck` - 타입 체크
- `pnpm lint` - 린팅
UI 스토리의 경우 다음도 포함:
- dev-browser 스킬을 사용하여 브라우저에서 확인
이 섹션은 변환 도구(ralph-tui-create-json, ralph-tui-create-beads)에 의해 추출되어 각 스토리의 인수 기준에 추가됩니다.
4. 사용자 스토리
각 스토리에는 다음이 필요합니다:
- 제목: 짧고 설명적인 이름
- 설명: "[사용자]로서, [기능]을 원합니다. 그래서 [혜택]을 얻습니다."
- 인수 기준: "완료"의 의미를 검증 가능한 체크리스트로 작성
각 스토리는 한 번의 집중된 AI 에이전트 세션에서 구현할 수 있을 정도로 작아야 합니다.
형식:
### US-001: [제목]
**설명:** [사용자]로서, [기능]을 원합니다. 그래서 [혜택]을 얻습니다.
**인수 기준:**
- [ ] 구체적인 검증 가능 기준
- [ ] 또 다른 기준
참고: 개별 스토리 기준에 품질 게이트 명령어를 포함하지 마십시오. 품질 게이트 섹션에 한 번 정의되며 변환 중 자동으로 적용됩니다.
중요:
- 인수 기준은 검증 가능해야 하며 모호하지 않아야 합니다.
- "올바르게 작동"은 나쁜 예입니다.
- "버튼이 삭제 전 확인 대화상자를 표시"는 좋은 예입니다.
- 각 스토리는 독립적으로 완료 가능해야 합니다.
5. 기능 요구사항
번호가 매겨진 구체적인 기능 목록:
- "FR-1: 시스템은 사용자가 ...을 할 수 있도록 해야 함"
- "FR-2: 사용자가 X를 클릭하면 시스템은 ...을 해야 함"
명시적이고 모호하지 않게 작성하십시오.
6. 비목표(범위 외)
이 기능에 포함되지 않을 사항. 범위 관리에 매우 중요합니다.
7. 기술적 고려사항(선택 사항)
- 알려진 제약 조건 또는 종속성
- 기존 시스템과의 통합 지점
- 성능 요구사항
8. 성공 지표
성공은 어떻게 측정되나요?
9. 미해결 질문
남아 있는 질문이나 명확화가 필요한 영역.
AI 에이전트를 위한 작성
PRD는 ralph-tui를 통해 AI 코딩 에이전트에 의해 실행됩니다. 따라서:
- 명시적이고 모호하지 않게 작성
- 사용자 스토리는 작게 유지(한 세션에 완료 가능)
- 인수 기준은 가능한 한 기계 검증 가능해야 함
- 알고 있는 특정 파일 경로를 포함
- 프로젝트의 기존 코드 패턴을 참조
출력 형식
중요: TUI 파싱을 위해 최종 PRD를 마커로 감싸십시오:
[PRD]
# PRD: 기능명
## 개요
...
## 품질 게이트
...
## 사용자 스토리
...
[/PRD]
파일 이름: TUI는 ./tasks/prd-[기능명].md에 저장합니다.
예시 대화 흐름
사용자: TUI에 다크 모드를 추가하는 PRD를 작성해주세요.
어시스턴트: 다크 모드에 대한 PRD 작성을 도와드리겠습니다. 몇 가지 질문을 드리겠습니다:
-
주요 목표는 무엇인가요? A. 긴 세션 동안 눈의 피로 감소 B. 시스템 테마 설정과 일치 C. 시각적 사용자 정의 제공 D. 기타
-
설정이 지속되어야 하나요? A. 예, 설정 파일에 저장 B. 아니요, 세션만 유지 C. 시스템 설정 따르기
사용자: 1A, 2A
어시스턴트: 좋습니다! 몇 가지 더 질문드리겠습니다:
-
다크 모드를 지원해야 하는 구성 요소는 무엇인가요? A. 모든 TUI 구성 요소 B. 메인 실행 화면만 C. 메인 화면 + 설정 D. 기타
-
각 스토리가 통과해야 하는 품질 명령어는 무엇인가요? A. pnpm typecheck && pnpm lint B. npm run typecheck && npm run lint C. bun run typecheck D. 기타: [명령어 지정]
-
UI 스토리의 경우 브라우저 확인을 포함해야 하나요? A. 예, dev-browser 스킬 사용 B. 아니요, 자동화된 테스트로 충분합니다.
사용자: 3A, 4A, 5A
어시스턴트: 완벽합니다. PRD를 생성하기에 충분한 정보를 얻었습니다.
[PRD]
PRD: Ralph TUI 다크 모드
개요
긴 오케스트레이션 세션 동안 눈의 피로를 줄이기 위해 ralph-tui에 다크 모드 지원을 추가합니다. 이 기능은 모든 TUI 구성 요소에 적용되며 사용자의 설정을 설정 파일에 저장합니다.
목표
- 저조도 환경에서 편안한 시청 경험 제공
- 세션 간 테마 설정 유지
- 모든 TUI 구성 요소에 일관된 스타일 적용
품질 게이트
다음 명령어는 모든 사용자 스토리가 통과해야 합니다:
pnpm typecheck- 타입 체크pnpm lint- 린팅
UI 스토리의 경우 다음도 포함:
- dev-browser 스킬을 사용하여 브라우저에서 확인
사용자 스토리
US-001: 테마 설정 추가
설명: 사용자로서, 선호하는 테마(라이트/다크)를 설정하여 세션 간 유지되기를 원합니다.
인수 기준:
-
.ralph-tui.yaml스키마에theme필드 추가 - 지원 값: "light", "dark", "system"
- 하위 호환성을 위해 기본값은 "light"
US-002: 다크 테마 색상 팔레트 생성
설명: 사용자로서, 눈에 편안한 부드러운 대비의 다크 테마를 원합니다.
인수 기준:
- 회색 톤(순수 검정 아님)의 다크 팔레트 정의
- 충분한 대비 비율(WCAG AA) 보장
- 모든 UI 상태(선택됨, 호버, 비활성화)에서 색상이 잘 작동
US-003: TUI 구성 요소에 테마 적용
설명: 사용자로서, 모든 TUI 구성 요소가 내 테마 설정을 따르기를 원합니다.
인수 기준:
- 헤더 구성 요소가 테마 색상 사용
- 작업 목록이 테마 색상 사용
- 세부 패널이 테마 색상 사용
- 진행 표시줄이 테마 색상 사용
- 대화상자가 테마 색상 사용
US-004: 설정에 테마 전환 추가
설명: 사용자로서, TUI 설정 내에서 테마를 전환할 수 있기를 원합니다.
인수 기준:
- 설정 화면에 테마 옵션 표시
- 변경 사항이 재시작 없이 즉시 적용
- 변경 사항이 설정 파일에 저장
기능 요구사항
- FR-1: 테마 설정은
.ralph-tui.yaml에서 읽을 수 있어야 함 - FR-2: 테마는 TUI 시작 시 적용되어야 함
- FR-3: 설정에서 테마 변경은 즉시 적용되어야 함
- FR-4: 모든 텍스트는 두 테마 모두에서 가독성을 유지해야 함
비목표
- 시스템 테마 자동 감지(향후 개선 사항)
- 라이트/다크 외 사용자 정의 색상 구성표
- 구성 요소별 테마 재정의
기술적 고려사항
- 가능한 경우 기존 OpenTUI 테마 기능 사용
- React 구성 요소를 위한 ThemeContext 생성 고려
- 테마 변경 시 리렌더링 최소화
성공 지표
- 모든 구성 요소가 다크 모드에서 올바르게 렌더링
- 접근성 대비 문제 없음
- 테마가 세션 간 유지
미해결 질문
- v2에서 시스템 테마 설정을 자동으로 감지해야 할까요? [/PRD]
체크리스트
PRD를 출력하기 전에:
- 문자 선택 옵션이 있는 명확화 질문 수행
- 품질 게이트에 대해 질문(필수)
- 필요 시 후속 질문 수행
- 프로젝트별 명령어가 포함된 품질 게이트 섹션 포함
- 사용자 스토리가 작고 독립적으로 완료 가능함
- 사용자 스토리에 품질 게이트 명령어가 포함되지 않음(품질 게이트 섹션에 있음)
- 기능 요구사항이 번호가 매겨져 있고 모호하지 않음
- 비목표 섹션이 명확한 경계를 정의
- PRD가
[PRD]...[/PRD]마커로 감싸져 있음