본문으로 건너뛰기

모든 코딩 에이전트가 읽어요.

SpecWeave에는 서비스도 계정도 필요 없어요. 코딩 에이전트가 저장소의 파일을 읽기 때문에 Claude Code, Codex, Grok 등이 같은 스펙과 원장을 이어받아요.

일러스트 · 모든 에이전트가 저장소의 같은 파일을 읽어요

코딩 에이전트

CLI는 어떤 도구에서든 같아서, 스킬이 없는 도구도 같은 루프를 실행해요. 도구 간 전환이나 같은 도구의 구독 간 전환은 핸드오프와 이어받기예요. 자세한 내용은 Codex, Grok 등에서 확인하세요.

  • Claude Code, Projects 스레드 포함

    읽는 파일
    CLAUDE.md, AGENTS.md를 가져옴
    스킬
    .claude/skills/
  • Codex

    읽는 파일
    AGENTS.md
    스킬
    .agents/skills/
  • Grok Build

    읽는 파일
    AGENTS.md와 CLAUDE.md
    스킬
    .grok/skills/, .agents/skills/, Claude Code 스킬
  • Cursor, GitHub Copilot, Gemini CLI, OpenCode

    읽는 파일
    AGENTS.md
    스킬
    각자의 폴더 또는 CLI 직접 사용

이슈 트래커 (선택)

푸시는 외부에 쓰는 작업이라서 직접 실행할 때만 일어나요. 인크리먼트를 시작, 일시 중지, 재개해도 트래커는 건드리지 않고, 푸시 외에는 이슈를 만들지 않아요. 인크리먼트를 완료하면 완료 시 닫기 설정이 켜져 있을 때만 푸시로 연결된 이슈를 닫아요. 이 설정은 sync setup로 켜고 끌 수 있어요. sync pull는 트래커에서 바뀐 내용을 검토용으로 보고하며, 로컬 파일은 덮어쓰지 않아요.

  • GitHub Issues

    이럴 때 유용해요이슈와 코드가 같은 곳에 있을 때.

    GitHub
  • Jira

    이럴 때 유용해요제품팀과 엔지니어링팀이 기존 전달 프로세스를 함께 쓸 때.

    Jira와 Azure DevOps
  • Azure DevOps

    이럴 때 유용해요조직이 작업 항목과 보드로 계획을 세울 때.

    Jira와 Azure DevOps
specweave sync setup           # 트래커 연결
specweave sync status          # 자격 증명, 상태, 변경될 내용
specweave sync push 0042       # 원할 때 진행 상황 게시
specweave sync pull            # 트래커에서 일어난 변경 보고

역할 분담

닫힌 이슈는 인수 기준 통과의 증거가 아니에요. 통과한 verify 보고서가 증거예요.

저장소에

스펙과 원장

스펙과 원장에는 완료의 의미와 검증된 내용이 기록돼요.

트래커에

계획 컨텍스트

트래커에는 우선순위, 담당자, 레이블, 이해관계자가 확인하는 위치 같은 계획 컨텍스트가 있어요.

트래커가 꼭 필요한가요?

아니요. 스펙, 원장, 핸드오프, 대시보드는 모두 로컬에서 작동해요. 협업이 더 쉬워질 때 트래커를 추가하세요.

대시보드에서 카드를 옮기면 Jira도 업데이트되나요?

아니요. 보드 변경은 로컬에만 적용돼요. 트래커를 업데이트하려면 해당 인크리먼트에 specweave sync push를 실행하세요.

팀은 어떻게 평가하면 좋을까요?

저장소 하나와 임시 트래커 프로젝트로 시작하세요. 실제 트래커를 연결하기 전에 sync push --dry-run로 매핑, 권한, 다시 열린 이슈, 부분 실패를 확인해 보세요.

SpecWeave의 다른 도구