Khởi tạo project mới với ak:bootstrap

Dùng ak:bootstrap để đưa project mới từ outcome đã chấp nhận tới code chạy được. Skill điều phối research, chọn stack, design, planning, implementation, testing, review, documentation và onboarding thay vì chỉ tạo một scaffold khó kiểm chứng.

Chọn ak:bootstrap cho project mới

Dùng ak:bootstrap khi

• Bạn bắt đầu project hoặc full-stack setup từ đầu.
• Bạn có thể nêu product outcome, constraint, non-goal và acceptance criteria quan sát được.
• Bạn muốn nối quyết định stack và design với implementation đã kiểm thử.
• Bạn chấp nhận mode đã chọn tạo project file, plan và documentation.

Chọn workflow khác khi

• Bạn đang thay đổi project hiện có với scope đã rõ. Dùng ak:cook.
• Bạn vẫn cần so sánh product direction. Dùng ak:brainstorm trước.
• Bạn chỉ cần implementation plan. Dùng ak:plan.
• Bạn cần đưa code hiện có ra CLI hoặc MCP server. Dùng ak:agentize.

Chuẩn bị project và runtime

Trước khi bắt đầu:

• Hoàn thành Làm quen và xác nhận Engineer Kit đã được cài cho runtime cùng scope đang dùng.
• Mở directory sẽ sở hữu project mới.
• Quyết định có cho phép khởi tạo Git nếu directory chưa là repository không.
• Nêu constraint bắt buộc về stack, compatibility, security, delivery và licensing trước khi bắt đầu lựa chọn tự động.
• Không đưa credential vào request. Chỉ cung cấp sau qua setup flow được project chấp nhận.

Xem Runtime adapter trước khi cho rằng mọi runtime có cùng orchestration control.

Chạy Skill

/ak:bootstrap "Create a private incident-response dashboard with SSO, an audit log, and no billing in v1" --full

/ak:bootstrap "Create a private incident-response dashboard with SSO, an audit log, and no billing in v1" --full

$ak:bootstrap "Create a private incident-response dashboard with SSO, an audit log, and no billing in v1" --full

Nếu không truyền cờ, Skill dùng --full.

--yagni kết hợp được với mọi mode. Flag này opt in vào việc challenge và cắt scope không cần thiết cho outcome đã nêu; khi không có flag, Skill scaffold đầy đủ scope được yêu cầu và không thêm phần việc ngoài yêu cầu. Flag được chuyển tiếp tới ak:plan và ak:cook để lựa chọn này tồn tại qua từng handoff.

Mô tả project rõ ràng

Một request hữu ích gồm:

• Outcome: Nêu người dùng có thể làm gì khi project chạy.
• Constraints: Nêu technology, platform, compatibility, security rule và delivery boundary bắt buộc.
• Non-goals: Loại trừ feature gần kề không nên vào implementation đầu tiên.
• Acceptance criteria: Đưa ra phép kiểm tra quan sát được cho main path, failure behavior và edge case quan trọng.
• Authority boundary: Nêu có cho phép Git initialization, dependency installation, external research, asset generation, commit, publication hoặc deployment không.

Với ví dụ incident response, hãy nêu thêm ai được xem incident, event nào vào audit log, “private” có nghĩa gì và validation nào chứng minh release đầu dùng được.

Hiểu workflow

1. Skill khóa project contract. Skill ghi nhận hoặc dùng lại outcome, constraint, non-goal và acceptance criteria trước mọi setup work.
2. Skill kiểm tra trạng thái Git. Với --full, Skill hỏi trước khi khởi tạo Git. Với --auto, --fast và --parallel, workflow khởi tạo repository còn thiếu qua Git workflow.
3. Skill research và chọn setup. Độ sâu, parallelism và approval gate theo mode đã chọn.
4. Skill tạo design evidence khi phù hợp. Skill có thể tạo design guidance, wireframe, screenshot và generated asset qua design cùng media tool khả dụng.
5. Skill tạo plan. Skill gọi ak:plan với hành vi theo mode và giữ nguyên contract đã chấp nhận.
6. Skill triển khai qua ak:cook. Plan được chuyển cho ak:cook; testing và code review theo workflow đó thay vì các edit trực tiếp không được theo dõi.
7. Skill hoàn tất project handoff. Skill đánh giá documentation, cập nhật plan state, hướng dẫn onboarding và báo changed file, check, risk cùng next action.

Giữ quyền phê duyệt và an toàn ở bạn

Automatic execution không cấp authority ngoài scope. External research, asset generation, dependency installation, credential use, commit, push, publication và deployment vẫn phụ thuộc tool khả dụng cùng scope bạn đã duyệt. Git action cuối vẫn là câu hỏi riêng.

Parallel mode cần exclusive file ownership và dependency rõ ràng. Worker hoặc worktree riêng giúp giảm edit collision; chúng không phải operating-system sandbox và không làm conflicting change tự động an toàn để merge.

Xác minh kết quả

Một lần chạy hoàn tất nên cung cấp:

• Project chạy được và khớp outcome cùng non-goal đã chấp nhận.
• Plan với phase state hiện tại và acceptance criteria.
• Quyết định stack cùng design được ghi trong documentation của project khi có ảnh hưởng lâu dài.
• Test thực và project check, với failure đã xử lý hoặc được báo rõ.
• Kết quả code review không che giấu critical finding.
• Bước onboarding cho phần configuration vẫn cần bạn thực hiện.
• Final report ngắn gọn với changed file, validation, remaining risk và câu hỏi chưa giải quyết.

Xem generated wireframe hoặc passing build là bằng chứng trung gian. Project chỉ hoàn tất khi acceptance criteria, test, review và onboarding path thống nhất.

Xử lý sự cố hoặc tiếp tục

Tiếp tục với Cài đặt Kit, Engineer Kit hoặc ak:cook khi project đã có implementation scope được chấp nhận.

Biết các giới hạn hiện tại

• Skill phụ thuộc planning, implementation, testing, review, design và media capability thực sự khả dụng trong runtime hiện tại.
• Dependency cùng asset tool có thể cần network access hoặc provider setup; workflow không thể tạo credential hay service availability còn thiếu.
• --fast giảm research overhead, không giảm implementation verification.
• --parallel chỉ hữu ích khi công việc tách được thành ownership độc lập.
• Stable và beta chứa cùng workflow cùng mode behavior của ak:bootstrap.