Spec-driven development cho AI agent: thử OpenSpec và các tool khác

Demo vòng lặp change của OpenSpec trên một project Laravel, so với Agent OS, Spec Kit, BMAD, và workflow bằng bộ prompt của team Povilas.

Đã duyệt độc lập · cập nhật 12/11/2026 · 28 min

1. Spec-driven development và những câu hỏi từ người xem

Povilas Korop mở đầu bằng chủ đề của video: spec-driven development dành riêng cho AI coding assistant và agent. Theo anh (video đăng ngày 08/01/2026), cách làm này đã trở nên rất phổ biến trong mấy tháng trước đó, với các tool như OpenSpec (đang mở trên trình duyệt lúc anh nói), rồi Spec Kit, Agent OS, BMAD Method và một vài cái khác.

Trong khoảng một tuần trước khi quay (tính tới video đăng ngày 08/01/2026), anh đã xem khoảng một tá video về các tool này, tự thử một vài cái, và giờ muốn chia sẻ ý kiến của mình. Một lý do nữa là người xem đã hỏi anh mấy câu. Anh đưa ra vài bình luận kiểu như: hãy làm thêm video về chế độ như BMAD Method; hãy làm một video về chủ đề đó; hay "video tiếp theo anh chọn Spec Kit hay thứ gì khác". Vậy là mọi người có quan tâm, và video này cố gắng trả lời những câu hỏi đó.

Trang README của OpenSpec trên GitHub với logo chữ lớn và một terminal openspec view
README của repo Fission-AI/OpenSpec, với dòng "Spec-driven development for AI coding assistants." và một ảnh terminal chạy openspec view hiện OpenSpec Dashboard (trang repo trong video đăng ngày 08/01/2026).

2. Plan mode chưa đủ cho cả một project

Câu hỏi đầu tiên Povilas đặt ra: các tool này, và nói chung là methodology spec-driven development, giải quyết vấn đề gì? Theo anh (video đăng ngày 08/01/2026), chắc ai cũng đồng ý plan mode là một thứ tốt. Lên plan càng kỹ thì trong đa số trường hợp, kết quả AI agent làm ra càng tốt. Plan mode trong Claude Code là một bước đi đúng hướng.

Nhưng vấn đề của plan mode, theo Povilas (video đăng ngày 08/01/2026), là nó thường gắn với một prompt cụ thể, cho một feature cụ thể. Còn cả project thì sao? Nếu anh có một bản specification từ client, hay một job description, thì chia nó thành các phase thế nào? Giữ cho bản specification gốc luôn được cập nhật bằng cách nào? Đi từng task một ra sao? Các tool kia đưa ra một cấu trúc để trả lời những câu đó.

Plan mode một prompt cụ thể cho một feature cụ thể Cả project chia specification thành phase? giữ spec gốc luôn cập nhật? đi từng task một thế nào?
Hình 2.1Khoảng trống Povilas mô tả trong video đăng ngày 08/01/2026: plan mode lo một feature, còn các tool spec-driven đưa ra cấu trúc cho các câu hỏi ở cấp project.

Anh chọn OpenSpec để minh hoạ, vì theo anh (video đăng ngày 08/01/2026) đó là tool đơn giản nhất trong nhóm này. Để thử, anh lấy một job thật trên Upwork tuyển senior full-stack developer cho một project về âm nhạc, rồi chạy vài bước đầu tiên của OpenSpec trên đó.

3. Khởi tạo OpenSpec trong một project Laravel

Việc đầu tiên là khởi tạo OpenSpec bên trong project. Povilas đã cài sẵn project dưới dạng một project Laravel, vì đó là framework anh thường làm. Nên anh có cấu trúc Laravel mặc định, mở terminal, rồi làm theo phần hướng dẫn khởi tạo trong documentation của OpenSpec. OpenSpec thì anh đã cài global từ trước (demo trong video đăng ngày 08/01/2026).

Anh nói thêm: OpenSpec và phần lớn các tool này không gắn với một AI agent nào (theo video đăng ngày 08/01/2026). Chúng chạy được trong Claude Code, Cursor và các tool khác. Tính tới lúc quay, anh là fan của Claude Code, nên anh dùng nó trong video.

Bước đầu tiên để khởi tạo OpenSpec trong project hiện tại là lệnh openspec init. Theo demo (video đăng ngày 08/01/2026), lệnh này tạo cấu trúc OpenSpec ngay trong project. Nó hỏi bấm Enter để tiếp tục, rồi cho chọn tool; anh chọn Claude Code và đi tiếp.

Tiếp theo là xem file openspec/project.md mà OpenSpec vừa sinh ra. Theo Povilas (video đăng ngày 08/01/2026), đây kiểu như bản nháp của những gì anh cần cung cấp làm context cho cả project. Lý tưởng là anh tự tay trả lời các câu hỏi trong file đó. Một đoạn của file, như mở trong editor:

# Project Context

## Purpose
[Describe your project's purpose and goals]

## Tech Stack
- [List your primary technologies]
- [e.g., TypeScript, React, Node.js]

## Project Conventions

### Code Style
[Describe your code style preferences, formatting rules, and naming
conventions]

### Architecture Patterns
[Document your architectural decisions and patterns]

### Testing Strategy
[Explain your testing approach and requirements]

### Git Workflow
File project.md của OpenSpec mở trong editor, các mục Purpose, Tech Stack, Project Conventions
File openspec/project.md ngay sau openspec init: các heading Purpose, Tech Stack, Code Style, Architecture Patterns, Testing Strategy, mỗi mục là một dòng gợi ý trong ngoặc vuông (demo trong video đăng ngày 08/01/2026).

Povilas nêu một chỗ: documentation chính thức của OpenSpec không thật sự đưa ví dụ phải làm gì khi đã có sẵn specification từ client (theo video đăng ngày 08/01/2026). Nên anh tự ứng biến: anh copy phần chính của job description, bỏ phần deliverables và cách ứng tuyển, rồi dán lên đầu file project.md.

4. Nhờ Claude Code bổ sung phần kỹ thuật cho project.md

Giờ cần thêm technical specification vào file. Mở lại terminal, phần output của openspec init có các gợi ý của OpenSpec, và anh copy rồi dán đúng gợi ý đó vào Claude Code. Phần Next steps trong terminal (demo trong video đăng ngày 08/01/2026):

Next steps - Copy these prompts to Claude Code:

1. Populate your project context:
   "Please read openspec/project.md and help me fill it out
    with details about my project, tech stack, and conventions"

2. Create your first change proposal:
   "I want to add [YOUR FEATURE HERE]. Please create an
    OpenSpec change proposal for this feature"

3. Learn the OpenSpec workflow:
   "Please explain the OpenSpec workflow from openspec/AGENTS.md
    and how I should work with you on this project"

Anh chạy Claude Code với chế độ dangerously skip permissions; anh có một alias cho việc này là ccc. Rồi anh dán instruction vào và chờ xem nó làm ra gì (demo trong video đăng ngày 08/01/2026).

Anh nhấn mạnh model đang dùng là Opus 4.5, và theo anh điều này khá quan trọng: model càng tốt thì kết quả của các tool specification càng tốt (theo video đăng ngày 08/01/2026).

Claude Code trả lời rằng project.md hiện tại có business context tốt nhưng thiếu chi tiết kỹ thuật, và đó đúng là thứ nó định bổ sung (demo trong video đăng ngày 08/01/2026). Nó xem cấu trúc project, thấy đây là project Laravel 12, và Povilas đoán nó sẽ cập nhật phần cấu trúc theo đó.

Khi Claude Code làm xong, file project.md đã có cấu trúc công nghệ backend và frontend của project (demo trong video đăng ngày 08/01/2026). Vẫn là phần project overview với tiêu đề cũ, cộng thêm coding conventions và những thứ tương tự.

Việc tiếp theo của anh, theo Povilas (video đăng ngày 08/01/2026), là review file đó và sửa những gì anh không muốn. Ví dụ, nó gợi ý các key relationship ở tầng database; có thể anh không đồng ý với SQLite và PostgreSQL mà thích MySQL hơn, và những chuyện kiểu vậy. Khi đã hài lòng với project.md, anh có thể bắt đầu prompt từng task một để có specification cho từng task.

5. Vòng lặp change: proposal, review, implement, archive

Trong documentation chính thức của OpenSpec, vòng lặp trông như thế này (theo Povilas, video đăng ngày 08/01/2026): với mỗi task muốn xử lý, anh draft một change proposal. Mỗi task là một change. Với mỗi change, anh sinh proposal, review nó, rồi để AI agent implement các task, archive khi xong, và chuyển sang task tiếp theo, change tiếp theo.

Mục How It Works trong README của OpenSpec với sơ đồ Draft Change Proposal, Review and Align, Implement Tasks
Mục "How It Works" trong README của OpenSpec (trang repo trong video đăng ngày 08/01/2026): Draft Change Proposal, "share intent with your AI", Review & Align (edit specs/tasks) có feedback loop, "approved plan", rồi Implement Tasks (AI writes code). Phía trên là dòng so sánh với spec-kit và Kiro của chính README.

Trong file project.md có danh sách core workflows, theo Povilas (video đăng ngày 08/01/2026) đó có lẽ là thứ gần nhất với một task list. Anh bảo nó làm task đầu tiên trong danh sách: tạo và chỉnh sửa gig (một buổi diễn).

Đó là vòng lặp change. Bước một là draft proposal. Có slash command /openspec:proposal, hoặc anh có thể viết tay bằng ngôn ngữ thường. Povilas dùng slash command rồi dán mô tả của task đó vào; dòng anh gõ bắt đầu như sau (demo trong video đăng ngày 08/01/2026):

/openspec:proposal Admin creates/edits gig

6. Draft proposal cho tính năng đầu tiên

Lúc này Claude Code bật plan mode, kèm các câu hỏi anh cần trả lời (demo trong video đăng ngày 08/01/2026). Povilas chọn phương án đầu tiên cho mọi câu, vì lúc này anh không thật sự quan tâm project chạy thế nào; anh không phải client ở đây. Sau đó OpenSpec cùng Claude Code sinh ra vài file cho feature đó.

Kết quả là một change mới tên Add Gig Management trong thư mục openspec/changes, và với change đó có proposal và task list (demo trong video đăng ngày 08/01/2026). Povilas nói đây chính là thứ anh chờ đợi, nhưng ở mức cả project; còn OpenSpec làm theo cách chi tiết hơn, tạo task list cho từng change của specification.

Vậy là có task list, có proposal về cả feature, và có thêm file spec.md mô tả kỹ hơn các requirement và cách feature đó phải hoạt động (demo trong video đăng ngày 08/01/2026).

Terminal Claude Code liệt kê các file vừa tạo trong openspec/changes/add-gig-management
Claude Code tóm tắt các quyết định dựa trên câu trả lời (tách date, start_time, call_time; một trường pay; không có gig lặp lại) và liệt kê file vừa tạo: proposal.md, tasks.md, specs/gig-management/spec.md; ô nhập gợi ý sẵn "approve, let's implement it" (demo trong video đăng ngày 08/01/2026).

Bước tiếp theo, theo Povilas (video đăng ngày 08/01/2026), là review mọi tài liệu này và đưa feedback hay chỉnh sửa cho tới khi anh hài lòng để Claude Code bắt tay implement task list. Anh xin lỗi vì giọng mình hơi run lúc này.

Anh có thể sửa các file bằng tay, hoặc prompt Claude Code, ví dụ "thêm cái này, cái kia", như documentation chính thức gợi ý (theo video đăng ngày 08/01/2026). Còn vài lệnh terminal nữa như openspec show hay validate, và rồi implement change.

Có slash command /openspec:apply cho đúng change đó, ở đây là add gig management. Anh có thể prompt Claude Code, nhưng thật ra Claude Code đã gợi ý sẵn prompt tiếp theo, nên anh bấm Enter, và nó tự chạy /openspec:apply (demo trong video đăng ngày 08/01/2026).

Theo Povilas (video đăng ngày 08/01/2026), đây là sự cộng tác giữa OpenSpec và Claude Code, ở đây với model Opus, cùng nhau implement change add gig management. Vì task list khá dài, anh đoán nó sẽ chạy khoảng mười phút.

7. Apply, review code rồi archive

Đó là task list trong Claude Code, và anh tiếp tục video sau khi nó chạy xong. Theo số đo của Povilas (video đăng ngày 08/01/2026), nó xong trong khoảng chín phút. Giờ đã có các file được sinh ra. Nhìn lại, anh nói có lẽ anh nên chọn một task nhỏ hơn, vì giờ có rất nhiều thứ phải review.

Anh sẽ không review, vì video này không nói về code Laravel mà nói về quy trình. Cứ coi như phần đó xong (demo trong video đăng ngày 08/01/2026). Việc tiếp theo là review code và prompt cho những chỗ cần sửa. Nhưng giả sử anh đã hài lòng với feature đó: archive nó thành "done" và chuyển sang feature kế bằng cách nào?

Anh quay lại documentation, và bước tiếp theo là archive feature cụ thể đó. Dòng anh gõ (demo trong video đăng ngày 08/01/2026):

/openspec:archive add-gig-management

Rồi anh nhìn cấu trúc thư mục thay đổi thế nào. Claude Code thật sự chạy lệnh archive của OpenSpec, lệnh này chuyển change vào thư mục con archive (demo trong video đăng ngày 08/01/2026). Giờ có openspec/changes/archive, còn thư mục changes thì trống: không còn change mới nào.

Terminal báo Archived successfully, change chuyển vào openspec/changes/archive
Terminal báo "Archived successfully": change chuyển tới openspec/changes/archive/2026-01-07-add-gig-management/, spec tạo ở openspec/specs/gig-management/spec.md với 7 requirements, Validation: Passed; ô nhập gợi ý "Add musician roster management next" (demo trong video đăng ngày 08/01/2026).

Để làm feature tiếp theo, anh lại quay về documentation và làm lại từ đầu: draft proposal cho feature kế, và vòng lặp cứ thế tiếp diễn. Tất nhiên, theo Povilas (video đăng ngày 08/01/2026), nếu thấy cái gì đó cần đổi thì feature mới, specification mới, proposal mới của anh trở thành change của feature trước. Và Claude Code thậm chí tự gợi ý feature tiếp theo: thêm quản lý musician roster (demo trong video đăng ngày 08/01/2026).

Vậy là anh đã thấy OpenSpec chạy ra sao: đưa job description ban đầu vào, rồi đi qua project theo từng feature, từng spec, từng change. Như đã nói, theo Povilas (video đăng ngày 08/01/2026), đây là cách dựng spec-driven development đơn giản nhất mà không làm nó phức tạp thêm.

Các tool khác, theo kinh nghiệm của anh, từ những gì anh xem trên YouTube và từ việc tự thử (video đăng ngày 08/01/2026), phức tạp hơn và đòi hỏi nhiều công sức hơn từ đầu trước khi tới được phần implement task. Anh lướt nhanh qua các tool đó và cách chúng hoạt động.

8. Agent OS: thêm vài bước, thêm vài lệnh

Ví dụ đầu tiên là Agent OS, theo Povilas (video đăng ngày 08/01/2026) cũng tương đối dễ. Trong documentation, workflow có thêm vài bước. Có bước plan product với một số file được sinh ra. Rồi vòng specification cho mỗi task đi qua shape spec, rồi write spec. Sau đó có create tasks là một lệnh riêng. Rồi có implement tasks hoặc orchestrate tasks, là hai workflow khác nhau.

Documentation của Agent OS, trang Plan Product, menu Workflow sáu bước
Trang Plan Product trong documentation của Agent OS (trang docs trong video đăng ngày 08/01/2026): menu Workflow gồm Plan Product, Shape Spec, Write Spec, Create Tasks, Implement Tasks, Orchestrate Tasks; mục "What gets created" liệt kê mission.md, roadmap.md, tech-stack.md trong agent-os/product/, và lệnh /plan-product cho Claude Code.

Vậy là, theo Povilas (video đăng ngày 08/01/2026), lại có kha khá thứ phải học mới dùng được tool này với cấu trúc của nó.

proposalapplyarchive OpenSpec plan productshape specwrite speccreate tasksimplement / orchestrate Agent OS
Hình 8.1Các bước Povilas đọc ra cho từng tool trong video đăng ngày 08/01/2026: vòng change ba bước của OpenSpec, và chuỗi bước của Agent OS, trong đó implement tasks và orchestrate tasks là hai workflow khác nhau.

9. Spec Kit của GitHub: nhiều khái niệm hơn khi đào sâu

Ví dụ tiếp theo là Spec Kit, do GitHub tạo ra, nên theo Povilas (video đăng ngày 08/01/2026) nó có một công ty khá lớn đứng sau. Sau khi cài, workflow là: /speckit.constitution cho các nguyên tắc của project, rồi tạo spec, rồi tạo technical implementation plan, chia thành task, và thực thi implementation.

Nhìn bề ngoài thì nó giống Agent OS và OpenSpec (theo Povilas, video đăng ngày 08/01/2026). Nhưng đào sâu vào documentation thì có khá nhiều khái niệm và cấu trúc bổ sung: tạo branch, đánh số feature tự động, những khái niệm mà theo ý kiến của anh nghiêng về môi trường doanh nghiệp lớn và ngôn ngữ doanh nghiệp.

File spec-driven.md trong repo spec-kit, mục Streamlining SDD with Commands
File spec-driven.md trong repo github/spec-kit (trang repo trong video đăng ngày 08/01/2026), mục "Streamlining SDD with Commands": lệnh /speckit.specify gồm Automatic Feature Numbering, Branch Creation, Template-Based Generation, Directory Structure; bên dưới là lệnh /speckit.plan.

10. BMAD Method: không hẳn là spec-driven development

Cuối cùng là BMAD Method, theo Povilas (video đăng ngày 08/01/2026) là cái lớn nhất trong số đó, vì nó không phải spec-driven development. Nó giống agile AI-driven development hơn, nghiêng về những thứ ở tầm tổng thể hơn, với một cấu trúc riêng gồm các AI agent chuyên biệt: anh nói 21 agent cho các mục đích khác nhau trong cùng một chu trình.

Rồi anh nói có 12 agent chuyên biệt như developer, architect, analyst, tech writer và các vai khác, mỗi agent nhận một phần việc của specification (theo video đăng ngày 08/01/2026). README của BMAD trong video có cả hai con số: "21 specialized AI agents across 4 official modules" ở phần giới thiệu, và "12 Specialized Agents" ở mục Meet Your Team.

Mục Meet Your Team trong README của BMAD-METHOD, bảng 12 Specialized Agents
Mục "Meet Your Team" trong README của bmad-code-org/BMAD-METHOD (trang repo trong video đăng ngày 08/01/2026): "12 Specialized Agents working in concert", chia bốn cột Development (Developer, UX Designer), Architecture (Architect, Test Architect), Product (PM, Analyst, Tech Writer), Leadership (Scrum Master, BMad Master).

Theo Povilas (video đăng ngày 08/01/2026), BMAD có 34 workflow khác nhau trải qua bốn phase, và rất nhiều thứ phải học. Để video ngắn lại, anh không demo nó.

11. Bình luận của người dùng và vấn đề chung của các methodology

Thay vào đó, anh cho xem vài bình luận YouTube của mọi người dưới một video về OpenSpec (bình luận trong video đăng ngày 08/01/2026). Một bình luận khen OpenSpec: "tôi không cần 10 trang spec BMAD hay nhiều file markdown". Một bình luận khác: người tạo ra Spec Kit rõ ràng không biết context engineering, quá nhiều thứ thừa (bloat). Một người nữa nói OpenSpec dễ hơn GitHub Spec Kit.

Nhưng theo Povilas (video đăng ngày 08/01/2026), đây là vấn đề chung của mọi methodology kia, cái nào anh cho xem cũng vậy: anh phải làm việc vất vả để theo đúng chuẩn của chúng, thay vì làm việc trên project của mình.

Và trên đường đi, anh có thể phát hiện ra tool đó không thật sự hợp với project hay trường hợp của mình, vì cấu trúc, ví dụ, quá chặt, và anh thậm chí không thể theo được 100% (theo Povilas, video đăng ngày 08/01/2026).

Nên theo ý anh (video đăng ngày 08/01/2026), các tool này, đặc biệt là những cái phức tạp như BMAD và Spec Kit, phù hợp hơn với công ty lớn và project lớn, những nơi đằng nào cũng cần một methodology nào đó để quản lý project. Với họ, cái này trở thành một phần quy trình, có lẽ là phần hướng tới AI. Về mặt project management, họ vốn đã làm thứ gì đó tương tự spec-driven development, nên tool này có thể hữu ích.

Một điều nữa Povilas để ý, trong các video YouTube đó và trong documentation của các tool (video đăng ngày 08/01/2026): chúng thường trình bày kịch bản lý tưởng, nơi specification đã rõ ràng ngay từ đầu. Anh đưa một ví dụ: "specify real-time chat system with history and user presence".

Ví dụ trong docs và video specification rõ ngay từ đầu "real-time chat system with history and user presence" Yêu cầu thật từ client phức tạp hơn, nhiều sắc thái hơn nhiều chỗ chưa rõ từ đầu requirement đổi giữa chừng
Hình 11.1Hai phía Povilas đặt cạnh nhau trong video đăng ngày 08/01/2026: kịch bản lý tưởng mà các tool trình bày, và job description thật từ client.

Thông thường, theo Povilas (video đăng ngày 08/01/2026), specification, job description hay mô tả task từ client phức tạp hơn nhiều, nhiều sắc thái hơn nhiều, và có lẽ có nhiều phần chưa rõ ngay từ đầu. Cũng khá thường xuyên, requirement thay đổi gần như ngay giữa lúc đang làm task, khi anh nhận ra điều gì đó. Lúc đó, câu hỏi trở thành cập nhật specification dọc đường thế nào để không làm hỏng gì, và những chuyện kiểu vậy.

12. Con dao hai lưỡi, và cách làm bằng một prompt

Theo ý kiến cá nhân của Povilas (video đăng ngày 08/01/2026), cấu trúc của bất kỳ tool nào anh vừa cho xem đều là con dao hai lưỡi, vừa là phước vừa là hoạ. Nó tuỳ vào loại project anh làm. Với project đơn giản, với trường hợp của anh như các project demo trên YouTube, website riêng của anh, hay các project anh review cho khách hàng, thì nó là quá mức cần thiết (overkill).

Quay lại task Upwork ban đầu, anh hỏi: chẳng phải dễ hơn nếu có một prompt để cắt việc đó thành các task sao? Kiểu như có một file task list dài, rồi bảo AI agent, Claude Code hay gì cũng được, làm từng task một và cập nhật file đó, đánh dấu done hay complete. Và nếu có gì thay đổi dọc đường, bảo Claude Code cập nhật file gốc, không cần cấu trúc chặt chẽ hay lệnh terminal riêng nào (theo Povilas, video đăng ngày 08/01/2026).

Theo Povilas (video đăng ngày 08/01/2026), thật sự có người làm vậy. Thariq, người ở team Claude Code, làm đúng như thế. Anh ấy có một prompt: đọc specification, phỏng vấn tôi, rồi cập nhật specification, và sau đó có thể ra một task list. Bài đăng của Thariq mà Povilas mở trên X (ngày 28/12/2025, theo bài đăng):

read this @SPEC.md and interview me in detail using the
AskUserQuestionTool about literally anything: technical
implementation, UI & UX, concerns, tradeoffs, etc. but make
sure the questions are not obvious

be very in-depth and continue interviewing me continually until
it's complete, then write the spec to the file
Bài đăng trên X: start with a minimal spec or prompt and ask Claude to interview you
Bài đăng của Thariq trên X (đăng 28/12/2025, mở trong video đăng ngày 08/01/2026): "start with a minimal spec or prompt and ask Claude to interview you using the AskUserQuestionTool", "then make a new session to execute the spec", kèm ảnh prompt ở trên.

Theo Povilas (video đăng ngày 08/01/2026), Thariq không dùng OpenSpec hay bất cứ tool nào khác, nhưng vẫn gọi quy trình đó là spec based.

Anh cũng sẽ cho xem cách làm của team mình, không có tool bên ngoài nào. Khoảng nửa năm trước (tính từ video đăng ngày 08/01/2026), anh và team bắt đầu xây một quy trình: một bộ prompt theo thứ tự, đi từ project specification tới task list, rồi cách làm việc với các task đó. Đây là workflow điển hình của team cho các project Laravel mới.

Anh nói tính tới video đăng ngày 08/01/2026 anh chưa từng cho ai xem nó, nên đây kiểu như một thứ độc quyền, vì nó khá lộn xộn: mọi thứ vẫn đang làm dở và anh chưa bao giờ chuẩn bị nó cho công chúng. Nhưng anh sẽ cho xem nhanh, như một lựa chọn thay thế cho các tool spec-driven kia.

13. Workflow tám bước của team Povilas cho project Laravel mới

Workflow có tám bước cho mỗi project mới, và bốn bước đầu là phần kỹ thuật liên quan tới Laravel (theo video đăng ngày 08/01/2026). Anh cần chọn starter kit. Anh cần cài bằng laravel new và cài các package. Anh cần thêm custom guidelines, việc anh làm cho Laravel và cho Filament nếu cần. Và Context7 là một tool bổ sung bên cạnh Laravel Boost, để có thêm documentation.

Danh sách các bước new-project-workflow: Initial Project Analysis, Laravel Installation, AI Guidelines, Context7, Project Description, User Stories, Database Structure
Thư mục new-project-workflow trong repo AI-Coding-Guidelines của team (trang trong video đăng ngày 08/01/2026): 1. Initial Project Analysis, 2. Laravel Installation, 3. AI Guidelines (.ai/guidelines, php artisan boost:install), 4. cài Context7, 5. Project Description (docs/project-description.md), 6. User Stories, 7. Database Structure.

Tới bước năm thì mới vào phần kiểu spec-driven development. Job description gốc, lấy từ đâu cũng được, ví dụ từ Upwork, được đưa vào file này. Với cùng job description Upwork xuyên suốt video, anh dán nó vào project-description.md (demo trong video đăng ngày 08/01/2026).

Trong đó anh cũng cần thêm chi tiết kỹ thuật như starter kit và bất cứ thứ gì anh muốn về mặt kỹ thuật. Ví dụ, ở đâu đó bên trong file, anh ghi tech stack, kèm các tool khác nếu cần (demo trong video đăng ngày 08/01/2026).

Rồi anh đi qua ba bước để biến bản mô tả đó thành task list. Đầu tiên, để làm rõ bản mô tả, anh nhờ AI chuẩn bị user stories. Theo Povilas (video đăng ngày 08/01/2026), từ user stories thì dễ chia project thành các story hơn nhiều, rồi review chúng và sửa ở mức chi tiết hơn.

Tiếp theo là một bước riêng mà theo anh không tool nào khác thật sự nhấn mạnh, nhưng cá nhân anh nghĩ là cực kỳ quan trọng: database structure (theo video đăng ngày 08/01/2026). Theo kinh nghiệm của anh, database structure ảnh hưởng tới, hay áp đặt, nhiều quyết định hơn về sau. Nếu database structure không đúng với hình dung của anh về project, thì sau này refactor khó hơn nhiều. Nên anh có một bước riêng cho nó.

Rồi từ hai bước đó, anh nhờ AI chuẩn bị các project phase (theo video đăng ngày 08/01/2026).

14. User stories: prompt có ví dụ và 12 câu hỏi

Trong thực tế, có một prompt riêng cho user stories. Prompt này tham chiếu tới các tài liệu và đưa ví dụ cho thấy anh muốn nói gì: một project description mẫu, cũng lấy từ Upwork, và các user stories mẫu của đúng project đó. Đoạn đầu của prompt, như mở trên GitHub trong video (video đăng ngày 08/01/2026):

Look at the file @docs/project-description.md and work out user stories for the project.

Ask me any clarifying questions to improve the result.

Save result in the file @docs/user-stories.md .

Below you will see an example Project Description and example User Stories from it. Please mimic similar structure and depth of details.
File prompt-user-stories.md trên GitHub, 800 lines, phần đầu prompt và mục Example Project Description
File prompt-user-stories.md (800 lines, 24 KB, theo trang trong video đăng ngày 08/01/2026): bốn dòng hướng dẫn ở đầu, rồi mục "Example Project Description" mở đầu một ví dụ mẫu.

Theo Povilas (video đăng ngày 08/01/2026), đây là điều chung khi làm với AI: càng cho thấy ví dụ thật về trước và sau, về thứ anh cần và ý anh muốn, thì nó càng học tốt; nó học từ ví dụ tốt hơn là từ prompt của anh.

Anh mở Claude Code và dán prompt lớn đó vào, 800 dòng, vì ví dụ khá chi tiết (demo trong video đăng ngày 08/01/2026). Claude Code hỏi lại anh, lần này là 12 câu hỏi cần trả lời.

Điều anh có lẽ sẽ thêm sau video này, theo lời anh (video đăng ngày 08/01/2026), là bảo prompt dùng AskUserQuestion tool của Claude Code để tự bật kiểu hội thoại dạng wizard, vì lúc này anh phải trả lời bằng tay, và anh làm ngay việc đó.

Terminal Claude Code liệt kê các câu hỏi làm rõ theo nhóm Authentication, Gig Assignments, Sub-Out Workflow, Pay, Notifications
Một phần các câu hỏi làm rõ Claude Code đặt ra (demo trong video đăng ngày 08/01/2026), xếp theo nhóm: Authentication & Onboarding, Gig Assignments, Sub-Out Workflow, Pay & Compensation, Notifications & Communication với các câu được đánh số từ 1 tới 10.

Đó là bộ câu trả lời: 12 câu trả lời ngắn, mà theo anh Claude Code với Opus hẳn sẽ hiểu (demo trong video đăng ngày 08/01/2026). Anh từng lo mình trả lời quá ngắn, nhưng không: theo kinh nghiệm của anh, cách đó thật sự hiệu quả. Cứ nói "no" hay gì đó, nhắc một từ trong câu trả lời, và thường thế là đủ.

Theo số đo của Povilas (video đăng ngày 08/01/2026), nó xong trong khoảng hai phút, và giờ có user stories: 39 user stories, trong một file markdown mới ở cùng thư mục docs.

Nó trông kiểu như một task list nhưng không hẳn (demo trong video đăng ngày 08/01/2026). Anh và team từng tranh luận nội bộ có nên tách user stories và task list ra không. Về cơ bản, theo Povilas, file này dành cho project management và cho client duyệt user stories, không có chi tiết kỹ thuật và không có plan implement. Nó về cơ bản là ai làm được gì.

Rồi tất nhiên bước tiếp theo là review xem mọi thứ đó có cần không và viết có ổn không. Đây là một tài liệu khá đồ sộ. Nhưng, theo Povilas (video đăng ngày 08/01/2026), càng lên plan nhiều cho AI agent, càng cung cấp nhiều chi tiết, kết quả càng tốt. Đây kiểu như bí mật, một bí mật ai cũng biết, để one-shot một prompt, vì specification đã đủ chi tiết sẵn rồi.

Và đây, theo Povilas (video đăng ngày 08/01/2026), là nơi anh thấy tương lai của nghề lập trình nói chung, của coder. Họ cần đi lên một tầng, trong năm 2026 và về sau, và tham gia vào project management, vào specification, vào việc định nghĩa test, acceptance criteria và những thứ tương tự. Rồi AI agent sẽ implement code, phần lớn code. Anh nghĩ đó là tương lai của chúng ta. Tất nhiên nó sẽ không đi từ không tới một ngay; nó sẽ diễn ra dần dần. Nhưng anh nghĩ lúc này cần chú ý nhiều hơn rất nhiều tới project management và specification trước khi code.

15. Database schema, rồi project phases

Sau user stories, prompt tiếp theo là database structure, dựa trên project description và user stories, kèm một số guideline riêng của team về cách làm với project Laravel (theo video đăng ngày 08/01/2026). Trong Claude Code, anh có thể clear context để không làm nó rối thêm, rồi đưa prompt kế cho database. Phần đầu prompt trên GitHub ghi: tạo một file markdown database gợi ý theo định dạng DBML, đặt trong @docs/database-schema.md, theo các requirement trong @docs/user-stories.md và @docs/project-description.md, theo best practice của database Laravel 12; mục "Guidelines for Laravel DB" có các dòng như không dùng Enum DB field trừ khi chắc chắn giá trị không đổi, không tạo bảng trùng tên với bảng mặc định của Laravel như "users" hay "jobs", và dùng package spatie/laravel-medialibrary cho upload file và ảnh.

Theo số đo của Povilas (video đăng ngày 08/01/2026), nó xong trong khoảng một phút, và có file mới database-schema.md.

Đây là file đó, và một lần nữa, theo Povilas (video đăng ngày 08/01/2026), anh nên review nó bằng tay. Bảng users, index nằm ở đâu, có muốn dùng varchar ở đây hay enum, ví dụ cho role, hay một bảng riêng. Rồi các lookup table cho instrument, region và những thứ khác. Pivot table có timestamps hay không. Ví dụ, anh thường không thích updated_at cho pivot table trong Laravel, vì nó hiếm khi được dùng một cách có giá trị, và vân vân.

Về cơ bản là anh review database schema, nhưng lúc này anh để nguyên. Rồi phase cuối là prompt này: từ user stories, project description và database schema, đưa ra danh sách task. Và một lần nữa, ở cuối mỗi prompt, anh và team cố gắng thêm chi tiết kỹ thuật; lúc này mới có một chi tiết, nhưng anh nghĩ sau này sẽ có thêm (theo video đăng ngày 08/01/2026). Một số task có thể đã xong, như Laravel đã cài và cấu hình, nên có một phần riêng trong prompt để đánh dấu chúng là done. Một đoạn của prompt, như mở trên GitHub trong video:

Plan this project into phases and what needs to be built. I want to have a complete task list that needs to happen, based on @docs/user-stories.md, @docs/project-description.md and @docs/database-schema.md .

For phases and sub-phases, use numeration like "Phase 1" or "Phase 5.3" so they could be referenced by numbers, when later given to AI agent to implement.

Check in the code, which tasks are already completed, and mark them accordingly. Put the result into @docs/project-phases.md .

Technical Detail

If project uses Livewire starter kit, then create new pages as Laravel Controllers and not as Livewire [...]
specifically stated otherwise or unless dynamic Livewire behavior is required on that page.

Lại clear Claude Code, vì không cần context từ trước, rồi anh dán prompt đó. Lần này nó vừa một màn hình. Nó sẽ cho ra task list, rồi anh prompt agent làm từng task một để implement (demo trong video đăng ngày 08/01/2026).

Theo Povilas (video đăng ngày 08/01/2026), cách này hơi khác spec-driven development nguyên bản, vốn tạo spec cho từng task và tạo vòng lặp cho từng task. Ở đây, methodology của anh và team, thứ đã thật sự mang lại kết quả trên khá nhiều project, là có một task list chi tiết, khá nhiều prompt ngay từ đầu. Task list được đánh số: task số một, task số hai, và cứ thế, nên dễ tham chiếu tới từng task.

Khi xong một task, anh cập nhật, hay thật ra nhờ AI agent cập nhật, task số mấy trong project phases thành done hay completed hay gì tuỳ anh, mà không bị ngợp bởi cấu trúc lệnh terminal hay slash command riêng (theo video đăng ngày 08/01/2026). Về cơ bản là anh prompt AI agent theo dạng tự do để viết spec cho project, rồi lại prompt AI agent đi qua các task.

Theo số đo của Povilas (video đăng ngày 08/01/2026), nó xong trong khoảng ba phút, và có file mới project-phases.md, với legend not started, completed hoặc partially completed, và danh sách task.

File project-phases.md với legend và Phase 1: Foundation, Phase 1.1 Enums, Phase 1.2 Migrations
File project-phases.md Claude Code vừa tạo (demo trong video đăng ngày 08/01/2026): legend [ ] Not started, [x] Completed, [~] Partially completed, rồi Phase 1: Foundation (Database & Core Models), Phase 1.1: Enums, Phase 1.2: Migrations.

Rồi để bắt đầu implement, việc anh làm là lại clear trong Claude Code, rồi bảo nó xem project phases và làm 1.1 chẳng hạn. Dòng anh gõ, như trong terminal (demo trong video đăng ngày 08/01/2026):

Look at @docs/project-phases.md and work on 1.1

Về cơ bản, theo Povilas (video đăng ngày 08/01/2026), anh prompt bằng ngôn ngữ thường, không quá nhiều cấu trúc, không overkill và không bị ngợp bởi một hệ thống nào đó.

16. Tự do thay vì cấu trúc, và tín hiệu từ Thariq và Brian Casel

Nó đơn giản là một bộ prompt, và theo Povilas (video đăng ngày 08/01/2026), nó cũng cho sự linh hoạt để đổi prompt bất cứ lúc nào: thêm gì đó, bỏ gì đó, đổi tên các file project description, stories và những thứ tương tự, và có thể thử nghiệm một cấu trúc khác trong tương lai. Đó là lý do anh thích sự tự do hơn các cách làm có cấu trúc như Spec Kit, OpenSpec và các tool khác.

Mặt khác, đó là sở thích cá nhân. Có thể trông như anh và team đang phát minh lại bánh xe: nếu đã có chuẩn, sao không dùng OpenSpec hay gì đó? Với một số người, một số project, thì dùng các tool có cấu trúc hơn sẽ hợp hơn. Còn anh và team thì bỏ phiếu cho sự tự do (theo video đăng ngày 08/01/2026).

Tới đây anh quay lại bài đăng gốc của Thariq từ team Claude Code. Trong đó không có tool nào ngoài AskUserQuestion tool có sẵn của Claude Code để có wizard hỏi đáp. Nên theo Povilas (video đăng ngày 08/01/2026), có vẻ như chính những người làm ra Claude Code không dùng tool specification bên ngoài nào.

Và còn một điều sâu sắc hơn mà Thariq nhắc tới khi trả lời một bài đăng khác: capability thay đổi theo từng model. Theo Povilas (video đăng ngày 08/01/2026), vì vậy khó có một tool chạy tốt với model, khi model liên tục thay đổi. Và chiến lược của Claude Code, ít nhất theo lời trả lời đó, là "we will build this more into product" (Thariq trả lời ngày 06/01, mở trong video đăng ngày 08/01/2026).

Nên Povilas nghĩ chuyện sẽ xảy ra trong Claude Code, và có thể ở các tool khác theo những hướng khác, là ngày càng ít cần tool bên ngoài chuyên biệt, vì nhiều tính năng bên ngoài sẽ được tích hợp sẵn vào Claude Code, vào Cursor, vào bất kỳ AI agent và IDE nào anh dùng (dự đoán trong video đăng ngày 08/01/2026).

Còn một bài đăng nữa, của Brian Casel, người tạo ra Agent OS, một trong các tool anh cho xem ở trên. Brian trả lời bài đăng của Povilas, trong đó Povilas đặt câu hỏi về các tool spec-driven development (bài đăng mở trong video đăng ngày 08/01/2026).

Bài trả lời của Brian Casel trên X về Agent OS và spec-driven development
Bài trả lời của Brian Casel trên X (ngày 06/01, mở trong video đăng ngày 08/01/2026): "(creator of Agent OS here) -- I actually agree with this take in 2026. Most of the need for these (including Agent OS) have fallen away as the models & tooling has gotten so much better in recent months.", rồi "Still some useful ideas in there though, and I still find SDD (using any tooling) is the way, most of the time." và "I have updates to Agent OS & content coming soon which is mostly aimed at subtraction than addition."

Theo Povilas (video đăng ngày 08/01/2026), Brian đồng ý với anh rằng phần lớn nhu cầu dùng các tool này đã không còn, khi model và tooling đã tốt lên rất nhiều. Povilas nghĩ Brian đặc biệt muốn nói tới Opus 4.5. Và chiến lược tương lai của Brian cho Agent OS thiên về bớt đi hơn là thêm tính năng và cấu trúc.

Nói gọn lại, theo Povilas (video đăng ngày 08/01/2026), ngày càng nhiều người dựa vào chính model, ở đây là Opus, và vào tool như Claude Code. Rồi chúng ta dựa vào việc prompt, mà về cơ bản có nghĩa là mỗi team và mỗi developer tự nghĩ ra bộ prompt của mình, kiểu như phát minh lại bánh xe. Nhưng mặt khác, có lẽ nó vốn phải như vậy.

Theo Povilas (video đăng ngày 08/01/2026), đây kiểu như miền viễn tây hoang dã của AI, và không ai thật sự biết mình đang làm gì. Mọi người cứ tiếp tục thử nghiệm. Đó cũng là việc anh đang làm: rất nhiều thử nghiệm, thử đủ thứ.

17. Lời khuyên cuối: làm thứ hợp với mình

Povilas nghĩ chuỗi thử nghiệm và lặp lại này sẽ tiếp diễn (video đăng ngày 08/01/2026). Model sẽ tốt lên. Tool sẽ tốt lên. Tool mới sẽ xuất hiện. Rồi tới một loạt methodology mới.

Nên lời khuyên tổng thể của anh (video đăng ngày 08/01/2026) là: làm bất cứ cách nào hợp với mình. Không có methodology nào cứ thế khớp với mọi project, mọi team, mọi use case.

Theo Povilas (video đăng ngày 08/01/2026), ý tưởng spec-driven development nói chung là một ý tưởng rất tốt về lý thuyết: cần cấu trúc hoá specification, cần đầu tư vào việc lên plan. Nhưng theo ý anh, tool không còn quan trọng như trước, kể cả so với khoảng ba tới sáu tháng trước đó.

Ý tưởng spec-driven development rất tốt về lý thuyết cấu trúc hoá specification, lên plan Tool cụ thể không còn quan trọng như ba tới sáu tháng trước
Hình 17.1Kết luận của Povilas trong video đăng ngày 08/01/2026: giữ ý tưởng, còn tool nào thì tuỳ project, team và use case.

Đó là suy nghĩ và các thử nghiệm của anh về spec-driven development cho tới thời điểm đó, như anh nói là tính tới tháng 01/2026 (video đăng ngày 08/01/2026).

Nguồn và liên kết 8 nguồn

  1. Tên gốc: Spec-Driven Development for AI Agents: I Tried OpenSpec and Others
  2. Sự kiện: YouTube
  3. Video gốc: https://www.youtube.com/watch?v=d3Glwdf_xA8 youtube.com
  4. Kênh YouTube AI Coding Daily (Povilas Korop): youtube.com/channel/UCIuDdCJXnKZb4CUzhVO-DcQ youtube.com
  5. OpenSpec, repo Fission-AI/OpenSpec, mô tả là "Spec-driven development (SDD) for AI coding assistants." (đọc ngày 12/11/2026): github.com/Fission-AI/OpenSpec github.com
  6. Spec Kit, repo github/spec-kit (đọc ngày 12/11/2026): github.com/github/spec-kit github.com
  7. Agent OS, trang documentation (đọc ngày 12/11/2026): buildermethods.com/agent-os buildermethods.com
  8. BMAD Method, repo bmad-code-org/BMAD-METHOD, mô tả là "Breakthrough Method for Agile Ai Driven Development" (đọc ngày 12/11/2026): github.com/bmad-code-org/BMAD-METHOD github.com