워크스페이스 구성
/refine-story, /qa-plan, /requirements-discovery, /meeting-minutes에서 가정하는 워크스페이스 수준 구성을 작성합니다. 이는 대화형 가이드 스킬이지 자동 스크립트가 아닙니다: 탐색하고, 결과를 제시하고, 확인한 후에만 파일을 작성합니다.
단계
-
탐색. 가정을 하기 전에 기존 파일을 검사합니다: 루트의
AGENTS.md와CLAUDE.md,CONTEXT.md,docs/agents/refinement.md및docs/agents/issue-tracker.md(이 스킬의 이전 출력물),.scratch/, 그리고 소스 코드의 신호:package.json,pyproject.toml,src/,go.mod, 또는 팀이 컴파일하거나 실행하는 모든 것.docs/agents/issue-tracker.md가 다른 규칙에서 이미 존재하는 경우, 유지하고 게시 위치만 지정하는지 확인합니다.CLAUDE.md가 단순히@AGENTS.md를 가리키는 브리지인 경우, 기본 지침 파일은AGENTS.md입니다. 완료 조건: 워크스페이스가 이미 구성되었는지, 예상 모드, 예상 언어(en-US또는pt-BR), 용어집 존재 여부, 추적기 존재 여부, 편집할 지침 파일을 알게 되었습니다. -
한 섹션씩 문의하며, 권장 답변을 먼저 제시합니다.
모드. 발견 사항에 따라 권장: 코드가 있으면
com-codigo(코드 포함); 없으면sem-codigo(코드 미포함). 한 줄로 설명: 코드 포함 시 에이전트가 질문 전에 소스 코드를 검사하고, 코드 미포함 시 PO가 사실의 출처이며 아키텍처 질문은 팀을 위한 질문지가 됩니다.언어. 기존 파일 또는 기본값
en-US에 따라 권장:en-US또는pt-BR. 한 줄로 설명: 검사, 질문 라운드, 내러티브, Gherkin 기준, 평결의 언어를 정의합니다.작업 항목. 사용자 스토리가 외부 추적기에서 시작됩니까? 그렇다면 기본 URL과 필드 규칙은 무엇입니까(예: Azure DevOps 작업 항목의 경우
Azure: <ID>). 모든 US는 거기서 시작되며 각 아티팩트는 이 ID 라인을 포함합니다.제품 용어집.
CONTEXT.md가 이미 존재합니까? 그렇지 않으면 지금 조치할 필요 없음: 도메인 용어를 해결하는 첫 번째 검사가 이를 생성합니다. 이를 명확히 설명합니다.완료 조건: 모드, 언어, 작업 항목 규칙 및 기본 URL이 확인되었습니다.
-
확인하고 작성합니다.
docs/agents/refinement.md의 초안을 refinement.md 기반으로,docs/agents/issue-tracker.md의 초안을 issue-tracker.md 기반으로(아직 존재하지 않는 경우에만), 그리고 에이전트 지침 파일의## Refinement블록을 제시합니다. 조정을 허용합니다. 그런 다음 파일을 작성합니다. 지침 파일의 경우:CLAUDE.md가 존재하고AGENTS.md를 가져오는 경우(@AGENTS.md),AGENTS.md를 편집합니다. 그렇지 않고CLAUDE.md가 존재하면CLAUDE.md를 편집하고, 그렇지 않으면AGENTS.md가 존재하면AGENTS.md를 편집합니다. 둘 다 없으면 어떤 것을 생성할지 묻습니다.## Refinement블록이 이미 존재하는 경우, 파일의 나머지 부분을 수정하지 않고 그 자리에서 업데이트합니다.블록:
## Refinement Socratic 정제 워크플로우: 워크플로우를 선택하려면 `/which-flow`를 실행합니다. 모드와 규칙은 `docs/agents/refinement.md`에 있고, 추적기 규칙은 `docs/agents/issue-tracker.md`에 있습니다. 아티팩트는 `.scratch/<slug>/`에 `Status:` 및 작업 항목 ID와 함께 저장됩니다.완료 조건:
refinement.md, 추적기 파일(신규 또는 유지), 지침 블록이 확인된 내용으로 존재합니다. -
마무리. 워크스페이스가 구성되었음을 확인하고
docs/agents/refinement.md를 읽는 워크플로우를 나열하며, 파일은 나중에 수동으로 편집할 수 있고 이 스킬을 다시 실행하는 것은 모드, 언어 또는 추적기 규칙을 전환할 때만 필요함을 알립니다.