One command — npx, curl or PowerShell — scaffolds the six-stage loop: intent, spec, plan, tests, review, monitoring, plus the Claude Code agents, skills and guardrail hooks that run it. Same output on macOS, Linux and Windows.
Một lệnh — npx, curl hoặc PowerShell — dựng sẵn vòng lặp sáu giai đoạn: intent, spec, plan, test, review, monitoring, kèm bộ agent, skill và hook bảo vệ của Claude Code. Kết quả giống hệt nhau trên macOS, Linux và Windows.
$ bash init.sh my-app -w node,python@3.12
[info] init-ai-sdlc 0.3.0
[info] Project / Du an: my-app
[info] Node: latest · Python: 3.12
[ok] CLAUDE.md
[ok] intent/_TEMPLATE.md
[ok] specs/_TEMPLATE.md
[ok] plans/_TEMPLATE.md
[ok] monitoring/bands.yaml
[ok] .claude/agents/planner.md # + coder, tester, reviewer, verifier
[ok] .claude/skills/feature/SKILL.md
[ok] .claude/hooks/guard-bash.sh
[ok] .github/workflows/agent-evals.yml
[ok] package.json (node latest)
[ok] pyproject.toml (python 3.12)
[ok] Makefile # make check = lint + test
[ok] AGENTS.md # read by every coding agent
[ok] AI-Native SDLC scaffold ready # 49 files
$ claude # then: /intent <your idea>Every stage commits one version-controlled file that the next stage reads. Agents do the work; you stay above the loop at two gates. Mỗi giai đoạn commit một file vào git để giai đoạn sau đọc. Agent làm việc; bạn đứng trên vòng lặp ở hai cổng duyệt.
Stage 1 · PlanGiai đoạn 1 · Plan
Turn an idea, ticket or incident into something concrete: problem, outcome, affected users, constraints, open questions. No design, no code yet.Biến ý tưởng, ticket hay sự cố thành thứ cụ thể: vấn đề, kết quả mong muốn, người dùng liên quan, ràng buộc, câu hỏi mở. Chưa thiết kế, chưa code.
Stage 2 · DesignGiai đoạn 2 · Design
Requirements and design the team can plan against. Policy skills — security, brand, UX, compliance — are applied, and conflicts between them are flagged, not hidden.Yêu cầu và thiết kế đủ rõ để lên kế hoạch. Các policy skill — bảo mật, thương hiệu, UX, tuân thủ — được áp dụng, xung đột giữa chúng được đánh dấu rõ.
Stage 3 · BuildGiai đoạn 3 · Build
The planner turns the spec into tasks, risks and proof. You approve it at Gate 1. Then the coder works on a feat/ branch — in parallel where files don't overlap.Planner chia spec thành task, rủi ro và bằng chứng cần có. Bạn duyệt ở Cổng 1. Sau đó coder làm trên nhánh feat/ — chạy song song khi các file không chồng nhau.
Stage 4 · TestGiai đoạn 4 · Test
The tester runs up to three rounds; product bugs go back to the coder. The protect-tests hook stops anyone weakening a test to make it pass. Agent regression evals run in CI.Tester chạy tối đa ba vòng; lỗi sản phẩm trả về cho coder. Hook protect-tests chặn việc sửa test cho dễ qua. Eval hồi quy cho agent chạy trong CI.
Stage 5 · DeployGiai đoạn 5 · Deploy
The reviewer checks the diff against REVIEW.md in up to two rounds. You approve the commit at Gate 2. It commits locally only — pushing and production deploys stay human.Reviewer soát diff theo REVIEW.md, tối đa hai vòng. Bạn duyệt commit ở Cổng 2. Chỉ commit trên máy — push và deploy production luôn do người làm.
Stage 6 · MaintainGiai đoạn 6 · Maintain
Deterministic bands decide when Claude is called and what it may do: log, diagnose, or propose a PR or rollback. No model in detection. Every incident becomes the next intent.Các ngưỡng tất định quyết định khi nào gọi Claude và Claude được làm gì: ghi log, chẩn đoán, hoặc đề xuất PR / rollback. Không dùng model để phát hiện. Mỗi sự cố thành intent kế tiếp.
Files from one commandFile từ một lệnh duy nhất
49
39 with no runtime, 49 with Node and Python, 55 with all four — including a Makefile, AGENTS.md and tests that actually run. Byte-for-byte identical from bash and PowerShell; re-running skips what exists unless you pass --force.39 file khi không chọn runtime, 49 file với Node và Python, 55 file với cả bốn — gồm Makefile, AGENTS.md và test chạy thật. Bash và PowerShell cho ra giống hệt từng byte; chạy lại sẽ bỏ qua file đã có, trừ khi dùng --force.
Subagents, one job eachSubagent, mỗi con một việc
5
planner · coder · tester · reviewer · verifier
Human gates, never skippedCổng duyệt của người, không bỏ qua
2
Approve the plan. Approve the commit. Nothing is pushed for you.Duyệt plan. Duyệt commit. Không có gì tự push.
Pick your runtimes and copy the command. The release tag lives in the URL, so the same version always produces the same scaffold. Chọn runtime rồi sao chép lệnh. Tag phiên bản nằm ngay trong URL, nên cùng một phiên bản luôn cho ra cùng một bộ khung.
More than one runtime makes a polyglot repo: make check then runs every stack in turn. Pick one unless you really want that.
Chọn nhiều runtime nghĩa là repo đa ngôn ngữ: make check sẽ chạy lần lượt từng stack. Chỉ nên chọn một, trừ khi bạn thật sự cần.
Short URL, always the latest release on main. For a build that can never change, switch to the pinned tag.
URL ngắn, luôn lấy bản mới nhất trên main. Muốn kết quả không bao giờ đổi thì chuyển sang bản ghim theo tag.
The tag is immutable: this exact command produces this exact scaffold, today and next year. Tag là bất biến: đúng lệnh này luôn cho ra đúng bộ khung này, hôm nay hay sang năm.
The script pins versions only (.nvmrc, .python-version, .tool-versions, manifests). Install runtimes with mise install, nvm or asdf.
Script chỉ ghim phiên bản (.nvmrc, .python-version, .tool-versions, manifest). Cài runtime bằng mise install, nvm hoặc asdf.
Needs only bash or PowerShell and git. jq is used later by the hooks.Chỉ cần bash hoặc PowerShell và git. jq được hook dùng về sau.
The Commands section (build, test, lint) is what lets agents verify their own work.Mục Commands (build, test, lint) là thứ giúp agent tự kiểm chứng công việc.
Open Claude Code in the folder and run /intent <your idea>.Mở Claude Code trong thư mục và chạy /intent <ý tưởng>.
Run it in the project root with --adopt. You get the agents, skills, hooks and stage folders — and nothing of yours is overwritten.Chạy ở thư mục gốc project với --adopt. Bạn nhận agent, skill, hook và thư mục các giai đoạn — không file nào của bạn bị ghi đè.
.bak..claude/settings.json được gộp, không bị thay — bản gốc giữ ở .bak.1 · Preview every change1 · Xem trước mọi thay đổi
npx ai-sdlc-starter@latest --adopt --dry-run2 · Apply it2 · Áp dụng
npx ai-sdlc-starter@latest --adoptNo Node? Use the builder above with Existing project ticked for the curl or PowerShell form.Không có Node? Dùng bộ tạo lệnh ở trên, tick Project có sẵn để lấy lệnh curl hoặc PowerShell.
A folder per stage, templates with bilingual guidance, and the Claude Code kit that operates the loop. Mỗi giai đoạn một thư mục, template kèm hướng dẫn song ngữ, và bộ Claude Code vận hành vòng lặp.
your-project/
├── intent/ # 1 Plan intent.md
├── specs/ # 2 Design spec.md
├── plans/ # 3 Build plan.md
├── src/ tests/ # code + tests
├── evals/ # 4 Test agent evals
├── REVIEW.md # 5 Deploy review policy
├── monitoring/ # 6 Maintain bands.yaml
├── docs/ # guide, ADRs, runbooks
├── .github/workflows/ # evals + review CI
├── CLAUDE.md # agent day-one context
├── AGENTS.md # same contract, every agent
├── Makefile # make check = the gate
└── .claude/
├── agents/ # 5 subagents
├── skills/ # /intent /spec /feature
├── hooks/ # 4 guardrails
└── settings.json # allow / deny + hooksEach starts empty and gets the artifact path — no hidden context, no "see above".Mỗi agent bắt đầu trống và nhận đường dẫn artifact — không ngữ cảnh ẩn, không "xem ở trên".
/feature is the orchestrator: plan → code → test → review, with both gates./feature là nhạc trưởng: plan → code → test → review, kèm cả hai cổng duyệt.
guard-bashblocks git push, rm -rf, sudo, DROP TABLEchặn git push, rm -rf, sudo, DROP TABLEformatauto-formats every edited filetự format mọi file vừa sửaprotect-testslocks test files during a fixkhóa file test khi đang sửa lỗiproduction-gateprod deploys need a named approvaldeploy production cần người duyệt có tênThey run for the main session and every subagent.Chạy cho phiên chính và mọi subagent.
From idea to a reviewed local commit. Agents loop on their own within bounded rounds; the decisions stay yours. Từ ý tưởng tới một commit đã được review trên máy. Agent tự lặp trong số vòng giới hạn; quyết định vẫn thuộc về bạn.
> /intent Add password reset via email
Claude asks what an analyst would ask, then writesClaude hỏi như một analyst, rồi viết intent/reset-password.md
> /spec intent/reset-password.md
Requirements, design, acceptance criteria and flagged risks inYêu cầu, thiết kế, tiêu chí chấp nhận và rủi ro được đánh dấu trong specs/reset-password.md
> /feature specs/reset-password.md
The planner writesPlanner viết plans/reset-password.md
Gate 1 — You approve the planCổng 1 — Bạn duyệt plan
Approve, request changes, or cancel. Nothing is coded before this.Duyệt, yêu cầu sửa, hoặc hủy. Chưa có dòng code nào trước bước này.
coder tester (≤ 3) reviewer (≤ 2)
Runs on its own branch. Every phase appends a row to the plan's pipeline log.Chạy trên nhánh riêng. Mỗi pha ghi thêm một dòng vào pipeline log của plan.
Gate 2 — You approve the commitCổng 2 — Bạn duyệt commit
A conventional commit lands on feat/reset-password, with a ready-to-paste PR description. You push.Một conventional commit trên feat/reset-password, kèm mô tả PR sẵn để dán. Bạn tự push.
ShippedĐã có
npx ai-sdlc-starterOn npm, plus the curl and PowerShell one-liners. Every release is tagged, so a pinned command always produces the same scaffold.Đã lên npm, cùng lệnh curl và PowerShell. Mỗi bản phát hành đều có tag, nên lệnh đã ghim luôn cho ra cùng một bộ khung.
NextTiếp theo
Secret scanning in both the pre-commit hook and CI, a dependency policy, a Stop hook that blocks a turn while make test is red, and a dev container.Quét secret ở cả pre-commit lẫn CI, chính sách cập nhật dependency, Stop hook chặn kết thúc lượt khi make test còn đỏ, và dev container.
LaterVề sau
More installers, more runtimes, and stages and skills suggested by the people using it.Thêm kênh cài đặt, thêm runtime, cùng các stage và skill do chính người dùng đề xuất.
Something missing?Chưa thấy câu trả lời? Ask on GitHubHỏi trên GitHub
.nvmrc, .python-version, .tool-versions and the matching manifest. Install runtimes with mise, nvm or asdf. This keeps the one-liner dependency-free.Không. Nó chỉ ghim phiên bản: .nvmrc, .python-version, .tool-versions và manifest tương ứng. Cài runtime bằng mise, nvm hoặc asdf. Nhờ vậy lệnh một dòng không phụ thuộc gì.--adopt. Without it, the script refuses to run in a folder that already holds a project, so a mistyped command cannot litter your repo. Try --adopt --dry-run first to see every change.Được: thêm --adopt. Không có cờ này, script từ chối chạy trong thư mục đã có project, nên gõ nhầm lệnh cũng không làm bẩn repo. Nên chạy --adopt --dry-run trước để xem mọi thay đổi.--force (-Force on Windows).Có. File đã tồn tại sẽ được bỏ qua, trừ khi bạn dùng --force (-Force trên Windows).git push is denied in settings.json and blocked again by the guard-bash hook. The pipeline commits locally only after Gate 2, and production deploys need a named approval.Không. git push bị cấm trong settings.json và bị hook guard-bash chặn thêm lần nữa. Pipeline chỉ commit trên máy sau Cổng 2, và deploy production cần người duyệt có tên.v0.1.0 gives every teammate and every CI run the exact same scaffold. Upgrade by changing the tag.Tag không bao giờ đổi, nên v0.1.0 cho mọi thành viên và mọi lần chạy CI cùng một bộ khung. Muốn nâng cấp, chỉ cần đổi tag.npx form. The curl and PowerShell one-liners run the scripts directly, and the scripts themselves need nothing but bash or PowerShell and git.Chỉ cần Node nếu bạn dùng npx. Lệnh curl và PowerShell chạy thẳng script, mà bản thân script chỉ cần bash hoặc PowerShell và git.Report a bug, suggest a stage or a skill, or share how your team runs it.Báo lỗi, đề xuất stage hay skill mới, hoặc chia sẻ cách team bạn vận hành.