SprintiQ – Giải pháp lập kế hoạch Sprint mã nguồn mở tích hợp với Claude Code

SprintiQ – Giải pháp lập kế hoạch Sprint mã nguồn mở tích hợp với Claude Code

SprintiQ được giới thiệu như một "bộ não sản phẩm" (product brain) dành cho Claude Code. Trong khi Claude Code tập trung vào việc viết mã, SprintiQ đóng vai trò là lớp quản lý nằm trên, quyết định những gì cần được xây dựng, khi nào và lý do tại sao. Về bản chất, đây không chỉ đơn thuần là một công cụ quản lý dự án, mà được xem là hệ điều hành cho các quy trình làm việc của Claude Code.

Dự án này được phát hành dưới dạng mã nguồn mở với giấy phép Apache 2.0, cho phép các nhà phát triển tự host, fork và mở rộng theo nhu cầu riêng.

Tính năng chính

SprintiQ cung cấp một bộ công cụ toàn diện để tối ưu hóa quy trình phát triển phần mềm tích hợp AI:

• Đồng bộ hóa hai chiều: Kết nối trực tiếp với Claude Code thông qua SprintiQ CLI (lệnh sprintiq watch), giúp giữ cho bảng sprint và mã nguồn luôn đồng bộ.
• Tạo User Story bằng AI: Hệ thống tạo câu chuyện người dùng có nhận diện về nhân vật (persona-aware) và được đào tạo để tránh các anti-patterns phổ biến trong Agile (TAWOS).
• Quản lý Sprint: Hỗ trợ lập kế hoạch sprint, quản lý năng lực (capacity management) và theo dõi vận tốc phát triển (velocity tracking).
• Quyền riêng tư dữ liệu: Được thiết kế cho người dùng đơn (single-user) và có khả năng tự host hoàn toàn, đảm bảo dữ liệu, hạ tầng và API key của bạn nằm dưới sự kiểm soát của bạn.

Kiến trúc và Công nghệ

SprintiQ được xây dựng trên một nền tảng công nghệ hiện đại và mạnh mẽ:

• Frontend & Framework: Sử dụng Next.js App Router để xây dựng giao diện người dùng và các route API.
• Backend & Database: Tận dụng Supabase để xác thực người dùng, cơ sở dữ liệu Postgres và pgvector cho các tác vụ liên quan đến vector.
• AI & Embeddings: Sử dụng Claude Sonnet 4.6 (và Opus) để tạo nội dung, cùng với Voyage AI để tạo embeddings.
• CLI: Gói lệnh @sprintiq/cli tạo ra một cầu nối trực tiếp giữa các phiên Claude Code và bảng sprint của bạn.

Cấu trúc dự án được tổ chức rõ ràng với các thư mục cho components, hooks, utilities và tests, sử dụng TypeScript để đảm bảo tính an toàn của kiểu dữ liệu. Hệ thống RLS (Row Level Security) của Supabase được áp dụng để cô lập không gian làm việc ở cấp độ cơ sở dữ liệu.

Cài đặt và Triển khai

Để tự host SprintiQ, bạn cần chuẩn bị các điều kiện sau:

• Node.js phiên bản 18 trở lên.
• Một dự án Supabase (miễn phí là đủ cho cá nhân).
• Anthropic API key (Claude Sonnet 4.6 + Opus).
• Voyage AI API key (dành cho embeddings).

Quy trình cài đặt cơ bản bao gồm các bước:

git clone https://github.com/SprintiQ-Incorporated/sprintiq.git
cd sprintiq
cp env.example .env.local
# Điền các biến môi trường cần thiết
npm install
npx supabase db push
npm run dev

Sau khi đẩy cơ sở dữ liệu, bạn cần tạo hai storage bucket trong dashboard của Supabase là avatars (công khai) và images (riêng tư). Để sử dụng CLI, bạn cần cài đặt gói CLI, build và link nó, sau đó chạy lệnh sprintiq watch để bắt đầu quá trình đồng bộ hóa.

SprintiQ Turbo hiện có sẵn dưới dạng mã nguồn mở để tự host, đồng thời phiên bản SaaS được cung cấp tại sprintiq.ai cho những ai muốn sử dụng dịch vụ được quản lý.