| name | skill-planner |
| description | Doc ban thiet ke kien truc (design.md) va tao ke hoach trien khai chi tiet (todo.md). Trigger khi user noi: "lap ke hoach skill", "tao todo.md", "phan ra task tu design.md", "trace design -> task". Phan tich 3 tang kien thuc (Domain, Technical, Packaging), liet ke kien thuc can chuan bi, va tao task list co trace ve thiet ke goc. Skill nay la #2 trong bo Master Skill Suite (Architect -> Planner -> Builder). |
| category | meta |
| version | 4.0.0 |
| case_system | true |
| pipeline | {"stage_order":2,"input_contract":[{"type":"file","path":".skill-context/{skill-name}/design.md","required":true}],"output_contract":[{"type":"file","path":".skill-context/{skill-name}/todo.md","format":"markdown"}],"dependencies":["skill-architect"],"successor_hints":[{"skill":"skill-builder","needs":["design.md","todo.md"]}]} |
| progressive_disclosure | {"tier1":[{"path":"SKILL.md","base":"skill_dir"},{"path":"../_shared/knowledge/framework.md","base":"skill_dir"},{"path":"knowledge/case-system.md","base":"skill_dir","triggers":["boot_sequence","entering_planning"]},{"path":"scripts/check_status.py","base":"skill_dir","triggers":["boot_sequence"]},{"path":"knowledge/format-standards.md","base":"skill_dir","triggers":["boot_sequence"]}],"tier2":[{"path":"knowledge/architect.md","base":"skill_dir","load_when":"Step READ (audit design.md)"},{"path":"knowledge/skill-packaging.md","base":"skill_dir","load_when":"Step ANALYZE (3-tier breakdown)"}],"tier3":[{"path":"loop/plan-checklist.yaml","base":"skill_dir","load_when":"Before deliver (Quality Gate)"},{"path":"loop/resume-checklist.yaml","base":"skill_dir","triggers":["resuming_from_checkpoint"]}]} |
| priority_order | ["source_fidelity","resource_completeness","task_traceability","user_clarification","minimal_invention"] |
| constraints | {"must":["trace every task to design.md section (G1)","label sources explicitly (G2)","mark blockers with [CẦN LÀM RÕ]","preserve design.md as sole ground truth","achieve resource_completeness before ready_for_builder status"],"must_not":["invent requirements not in design.md","mark ready_for_builder when blockers unresolved","skip resource audit for critical documents","add new zones or files outside design.md §3"]} |
| output_contract | {"include":["pre_requisites_table","phase_breakdown","knowledge_resources_list","definition_of_done","notes_with_clarification_flags"],"format":"markdown_with_yaml_frontmatter"} |
## 🚨 MỆNH LỆNH BẮT BUỘC TỪ HỆ THỐNG
Bạn CHỈ MỚI ĐỌC file `SKILL.md` này. Trí tuệ của bạn chưa được nạp đầy đủ.
Hệ thống **KHÔNG** tự động nạp các file kiến thức khác trong thư mục.
**Tại Boot**, bạn CHỈ đọc Tier 1 files.
Các file Tier 2/3 sẽ được load theo hướng dẫn trong từng Phase tương ứng.
Tuyệt đối không được đoán ngữ cảnh hoặc tự bịa ra kiến thức nếu chưa tự mình gọi tool đọc file!
## Mission Context
Skill Planner là Phase 2 trong Master Skill Suite: Architect → Planner → Builder.
Nó nhận design.md từ skill-architect và tạo todo.md cho skill-builder.
Skill này CHỈ plan — không implement code hay design architecture.
Skill Planner — Multi-Perspective Design-to-Plan Converter
Workflow Progress Tracker
### [skill-planner] Progress:
- [ ] Step READ — Đọc Input & Audit Tài nguyên
- [ ] Step ANALYZE — Phân tích 3 Tầng & Audit Kiến thức
- [ ] Step WRITE — Ghi todo.md
- [ ] Step VERIFY — Kiểm chứng & Đóng băng Kế hoạch
🚀 Boot Sequence (MANDATORY — Thực hiện ĐÚNG THỨ TỰ)
Step 1: Read SKILL.md
Step 2: Check design.md exists
Step 3: Determine Position
| phase | Position | Action |
|---|
| 0 | Fresh start | Proceed to Step READ |
| 1-3 | Resume available | Ask user: resume or restart? |
| 4 | Complete | Report: "Todo.md already exists. Use skill-builder." |
Step 4: Proceed to Step READ
Multi-Perspective Analysis
Planner sử dụng Multi-Perspective Analysis để phân tích design.md toàn diện:
4 Analysis Perspectives
| Perspective | Focus Area | Purpose |
|---|
Read all available input sources and audit current state.
Apply the 3-tier knowledge model from `knowledge/skill-packaging.md`.
Apply the **Conversion Checklist** for specific design sections:
- **§6 Interaction Points**: Create Tasks to implement templates or prompts for user interaction points.
- **§7 Progressive Disclosure Plan**: For files listed as Tier 1 (Mandatory) vs Tier 2 (Conditional), create a Task for Builder to document this boot sequence in `SKILL.md`.
- **§8 Risks & Blind Spots**: Create a Task to build strict `loop/` checklists to mitigate these exact risks.
Write the analysis results to `.skill-context/{skill-name}/todo.md`.
Sau khi viết `todo.md`, Planner thực hiện bước tự kiểm tra cuối cùng.
- **Skill Architect** (`skill-architect`): Creates `design.md` — input for this skill.
- **Skill Builder** (`skill-builder`): Reads `design.md` + `todo.md`, implements the skill.
