SprintiQ – Claude Code용 오픈소스 스프린트 계획

Source: Hacker News

Claude Code를 위한 제품 두뇌.

SprintiQ Turbo는 Claude Code 위에 놓이는 계획 레이어입니다. Claude Code가 코드를 작성하는 동안, SprintiQ는 무엇을 언제 왜 만들지—스프린트 계획, 스토리 생성, 속도 추적, 그리고 AI 코딩 에이전트와의 양방향 동기화를 관리합니다. 이것은 프로젝트 관리 도구가 아니라 Claude Code 워크플로우를 위한 운영 체제입니다.

이 저장소는 Apache 2.0 라이선스 하에 오픈 소스로 제공됩니다. 자유롭게 자체 호스팅, 포크 및 확장이 가능합니다.

이 저장소에 포함된 내용

• SprintiQ CLI(sprintiq watch)를 통한 Claude Code와의 양방향 동기화
• 애자일 안티패턴(TAWOS)으로 학습된 AI 기반 사용자 스토리 생성
• 스프린트 계획, 용량 관리 및 속도 추적
• 페르소나 인식 스토리 생성
• 단일 사용자, 자체 호스팅 가능 — 데이터, 인프라, Claude API 키를 직접 관리

빠른 시작 (자체 호스팅)

전체 배포 가이드는 SELF_HOSTING.md를 참고하세요.

사전 요구 사항

• Node.js 18 이상
• Supabase 프로젝트(개인용 무료 티어 충분)
• Anthropic API 키(Claude Sonnet 4.6 + Opus)
• Voyage AI API 키(임베딩용)

설정

git clone https://github.com/SprintiQ-Incorporated/sprintiq.git
cd sprintiq
cp env.example .env.local
# 필수 env 변수 입력 — SELF_HOSTING.md 참고
npm install
npx supabase db push
npm run dev

스토리지 버킷

supabase db push를 실행한 후 Supabase 대시보드에서 두 개의 스토리지 버킷을 생성합니다(스토리지 → 새 버킷):

CLI

cd packages/cli
npm install
npm run build
npm link
sprintiq watch

아키텍처

Next.js App Router, Supabase(인증, Postgres, pgvector), Claude Sonnet 4.6(생성), Voyage AI(임베딩) 위에 구축되었습니다. CLI(sprintiq watch)는 Claude Code 세션과 스프린트 보드 사이에 실시간 브리지를 생성합니다. RLS는 데이터베이스 레이어에서 단일 소유자 워크스페이스 격리를 강제합니다.

최상위 레이아웃:

app/        Next.js App Router 라우트(페이지 + API)
components/ React 컴포넌트
contexts/   React 컨텍스트 제공자
hooks/      커스텀 React 훅
lib/        서버‑사이드 유틸리티, 서비스, AI 제공자
packages/   @sprintiq/cli — AI 코딩 에이전트를 위한 CLI 브리지
public/     정적 자산
scripts/    운영 스크립트(마이그레이션, 감사, 학습)
supabase/   데이터베이스 마이그레이션
types/      공유 TypeScript 타입
e2e/        Playwright 엔드‑투‑엔드 테스트
__tests__/  Vitest 단위 및 통합 테스트

AI‑에이전트 중심 프로젝트 브리핑은 CLAUDE.md를 참고하세요.

개발

npm run dev          # Next.js 개발 서버 시작
npm run typecheck    # TypeScript 타입 검사 실행
npm run lint         # ESLint 실행
npm run test         # Vitest 단위 테스트 실행
npm run test:e2e     # Playwright 엔드‑투‑엔드 테스트 실행

기여

CONTRIBUTING.md를 확인하세요. 외부 풀 리퀘스트는 경우에 따라 검토되며, 버그 보고와 보안 공개는 언제나 환영합니다.

보안

책임 있는 공개 가이드라인은 SECURITY.md를 참고하세요.

라이선스

Apache 2.0 — 자세한 내용은 LICENSE를 확인하세요.

SprintiQ Turbo는 Apache 2.0 하에 오픈 소스입니다. 자체 호스팅하고, 포크하고, 기반 위에 구축하세요. SaaS 서비스는 sprintiq.ai에서 제공됩니다.