ADR 생성기은(는) 무엇을 하나요?
결정, 결정을 강제한 맥락, 고려된 옵션 및 수용된 결과를 설명하는 간결한 아키텍처 결정 기록(ADR)을 생성합니다.
활성화 계약
사용자가 ADR, 아키텍처 결정 기록, 기술 결정 기록 또는 기술적/아키텍처 선택이 이루어진 이유에 대한 공식 기록을 요청할 때 이 스킬을 사용하세요.
사용자가 완전한 ADR 초안을 작성하기에 충분한 정보를 이미 제공하지 않은 경우 기본적으로 인터뷰 모드로 전환합니다. 사용자 언어로 인터뷰 질문을 하세요. ADR 아티팩트 언어는 사용자가 명시적으로 다른 언어를 요청하지 않는 한 영어입니다.
엄격한 규칙
- 인터뷰 모드에서는 한 번에 하나의 질문만 하세요.
- 인터뷰 시작 시 사용자가 질문을 건너뛰거나 언제든지 인터뷰를 중단할 수 있다고 한 번 명시하세요.
- 동적인 예상 남은 질문 수 카운터를 유지하고, 종속성이 나타나거나 사라질 때 업데이트하세요.
- 사용자가 응답하는 데 도움이 될 때 짧은 예시 답변을 추천하세요.
- 인터뷰 질문을 일반 텍스트가 아닌 읽기 쉬운 마크다운으로 형식화하세요.
- 초안을 작성하기 전에 모호하거나 모순되거나 근거가 부족한 답변에 건설적으로 이의를 제기하세요. 사용자가 명시적으로 계속 진행하라고 하면 진행합니다.
- 대안, 장점, 단점 또는 근거를 임의로 만들지 마세요. 대안이 누락된 경우 질문하세요.
- 결정이 이미 이루어진 경우
Accepted를 사용하고, 제안, 평가 또는 상태가 불명확한 경우Proposed를 사용하세요. - 사용자가 명시적으로 파일/경로를 요청한 경우에만 파일을 작성하거나 수정하세요.
인터뷰 흐름
필요한 정보만 종속성 우선으로 수집합니다:
- 결정 제목 및 상태.
- 컨텍스트: 문제, 제약 조건, 압력 및 지금 이 결정이 중요한 이유.
- 선택된 옵션 또는 제안.
- 고려된 옵션(각각의 장단점 포함).
- 결과: 이점, 단점, 위험 및 트레이드오프.
- 유용한 미결 조치나 해결되지 않은 질문이 있는 경우에만 후속 조치.
질문 형식:
### 질문 N — [집중된 질문]
**권장 답변:** [필요한 경우 짧은 예시]
**중요한 이유:** [간단한 이유]
**예상 남은 질문 수:** ~M
미니 예시:
### 질문 1 — 이 결정은 이미 이루어졌습니까, 아니면 아직 제안 중입니까?
**권장 답변:** "Accepted — 청구 데이터에 PostgreSQL을 이미 선택했습니다."
**중요한 이유:** 상태에 따라 ADR이 최종 선택을 기록하는지 아니면 검토 중인 제안을 기록하는지가 결정됩니다.
**예상 남은 질문 수:** ~5
출력 계약
초안을 작성하기 전에 assets/template-markdown.md를 읽고 해당 구조를 채웁니다.
기본적으로 최종 ADR을 정확히 하나의 마크다운 코드 블록으로 반환하고 파일을 생성하지 마세요. 사용자가 명시적으로 파일/경로를 요청한 경우 해당 위치에 ADR을 저장하고 저장된 경로를 채팅에 요약하세요.
최종 ADR에 자리 표시자 지침을 남기지 마세요. 사용자가 의도적으로 필수 세부 정보를 건너뛰는 경우 해당 건너뛴 세부 정보에 대해서만 TBD를 절제하여 사용하세요.
참고
- 템플릿:
assets/template-markdown.md