Communitygithub.com

leonhoffmann86/team-sprint

🏃 스프린트 — 모든 TODO 항목이 완전한 미니-스프린트(자율 계획→구현→리뷰)로 전환됩니다. Claude Code를 위한 git-hook 에이전트 체인, 격리된 작업 트리, 결정적 게이트 및 실패-폐쇄 리뷰를 제공합니다.

team-sprint란 무엇인가요?

이 스킬은 개발자가 TODO.md에 등록된 작업을 정제하고 구조화하여, Claude Code의 자율적인 계획→구현→리뷰 체인이 실행될 수 있도록 준비하는 워크플로우입니다. 사용자가 제시한 대략적인 아이디어를 구체적인 파일 변경 사항, 위험 등급, 완료 기준 및 영향 범위를 포함하는 하나의 잘 구성된 태스크 항목으로 전환합니다. 특히, 프로젝트의 헌법 파일(sprint.conf, AGENTS.md, CLAUDE.md)에 정의된 위험 등급 및 자율 에이전트 규칙을 준수하며, 코드 그래프 도구를 활용하여 실제 코드 구조와 영향도를 분석합니다. 최종적으로 사용자의 승인을 받은 항목만 TODO.md에 기록하고, 필요에 따라 다른 활성 항목을 지연시킴으로써 단일 작업에 집중할 수 있도록 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add leonhoffmann86/team-sprint

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

당신은 대략적인 아이디어를 TODO.md에 있는 하나의 잘 구성된 태스크로 변환합니다. 대략적인 아이디어:

$ARGUMENTS

이것은 정제 워크플로우이지, 구현이 아닙니다. 코드를 작성하지 마십시오. 태스크가 명확해지고 사용자가 승인할 때까지 TODO.md에 작성하지 마십시오. 다음 단계로 작업하십시오:

1. 헌법 읽기

프로젝트의 헌법 파일을 찾아 읽고 — 그 규칙, 특히 위험 등급과 자율 에이전트 / TODO 수명주기 규칙을 준수하십시오.

  • sprint.conf가 존재하면 SPRINT_CONSTITUTION_FILES에 나열된 파일들을 (순서대로) 읽으십시오.
  • 그렇지 않으면 AGENTS.md, CLAUDE.md 중 존재하는 파일을 읽고 (그들이 참조하는 프로젝트별 가이드(예: 프론트엔드 CLAUDE.md)도 읽으십시오).
  • .githooks/README.md가 있으면 훑어보아, 다운스트림 효과를 올바르게 설명할 수 있도록 하십시오. 이러한 파일이 하나도 없으면, 저장소가 아직 부트스트랩되지 않았다고 사용자에게 알리고 /sprint:bootstrap을 제안하십시오.

2. 아이디어를 실제 코드에 근거하십시오 (추측하지 마십시오)

아이디어가 관련된 실제 기호/파일과 그 영향 범위를 찾으십시오:

  • 코드 그래프 (가능한 경우): mcp__codegraph__* 도구 (codegraph_search, …_callers, …_callees, …_impact, …_context), 또는 CLI (codegraph context "<아이디어>", codegraph callers <symbol>, codegraph impact <symbol>); 인덱스가 오래된 것 같으면 먼저 codegraph sync .를 실행하십시오.
  • 대체 방법 (코드 그래프 없음): Grep/Glob을 사용하여 관련 기호와 호출자를 찾으십시오. 실제로 중요한 몇 개의 파일을 읽으십시오. 구체적인 함수/파일 이름과 변경 사항이 적용될 위치를 명명하십시오.

3. 그것을 분석하십시오 (이 스킬의 핵심)

코드가 이미 수행하는 작업에 대해 아이디어를 검증하십시오. 다음을 표면화하십시오:

  • 질문인가, 태스크인가? 실제로 질문("...또는 제가 뭔가 놓치고 있나요?")이라면, 먼저 코드에서 답변하십시오 — 기존 로직이 이미 그 일부를 다루고 있을 수 있습니다.
  • 실제 범위와 가치를 제공하는 가장 작은 변경.
  • 위험 등급 (헌법 / AGENTS.md에 따라). 위험이 높으면 그렇게 말하십시오 — 자동으로 구현되지 않을 것입니다. 체인은 사람에게 위임합니다.
  • 사용자가 결정해야 할 사항이지, 당신이 결정할 사항이 아닙니다 (제품/UX/정책 선택). AskUserQuestion을 통해 사용자에게 그 몇 가지 결정을 물어보십시오. 진정한 제품 결정에 대한 답변을 만들어 내지 마십시오. 코드베이스의 증거를 사용하여 잘못된 가정을 수정하십시오.

4. 하나의 구조화된 항목을 초안으로 작성하십시오 (네 가지 구성 요소)

다음 내용으로 초안을 작성하십시오:

  1. 명확한 명령형 태스크 (질문이 아님),
  2. 위험 등급,
  3. 구체적인 완료 기준 (통과해야 하는 대상 테스트 / 검증 가능한 동작),
  4. 2단계의 파일/함수 힌트. 가장 작은 가치 있는 변경으로 유지하십시오. 초안을 보여주고 사용자가 만족할 때까지 정제하십시오.

5. TODO.md에 작성한 후 인계하십시오

  • 승인된 항목을 TODO.md의 상단 근처에 - [ ] 항목으로 추가하십시오.
  • 그것을 단일 활성 항목으로 만들지 물어보십시오 — 예인 경우, 스킵 규칙에 따라 다른 현재 활성 항목을 <!-- … --> 블록(또는 ## 🚧 지연됨 아래)으로 옮겨 체인이 이 항목만 선택하도록 하십시오.
  • 자동으로 커밋하지 마십시오. 사용자에게 알리십시오: TODO.md를 커밋하면 계획→구현→리뷰 체인이 시작됩니다 (구현은 impl 브랜치에 적용되며, 자동 병합되지 않습니다). 지금 프로세스를 시작하려면 커밋하겠다고 제안하십시오.

대화를 간결하게 유지하십시오: 먼저 근거를 마련하고, 중요한 결정만 묻고, 그런 다음 작성하십시오.

관련 스킬