Skill: plan

WHAT

Purpose và context

• Purpose: Biến SPEC đã duyệt thành văn bản mà một kỹ sư giỏi nhưng không biết gì về codebase này, và gu thì đáng ngờ vẫn thi hành đúng. Trong overstack, "kỹ sư" đó thường là một CLI rẻ chạy headless (opencode / agy / kiro): nó không thừa hưởng context nào của phiên chính, không hỏi lại được, và khi gặp chỗ mơ hồ nó sẽ đoán rồi im lặng. Thực đo bài học 250626: brief mỏng → giao hàng ~1/5.
• Trigger (when to use):
  • SPEC (/propose) đã được user duyệt ở cổng, và sắp dispatch task cho agent.
  • Việc nhiều bước, nhiều file, hoặc chia cho ≥2 agent chạy song song.
• Non-goals: KHÔNG dùng khi chưa có SPEC duyệt (dùng /propose trước), và không dùng cho sửa một dòng. Không dùng để thiết kế hay để hỏi yêu cầu (đó là /propose).

Mental model

Cái gì không nằm trong PLAN thì agent không có. Đó là toàn bộ nguyên lý của skill này.

SPEC đã duyệt (FR-xxx, Global constraints) → scope check → File structure → task tracer bullet (hoặc expand → migrate → contract) → mỗi task: Thoả + Files + Interfaces + Depends + Verify + Steps TDD → self-review → DDMMYY-<tên>-PLAN.md → orca orchestration task-create/dispatch --inject nguyên văn.