--- name: token-capped-workflow description: "Design a task workflow under an explicit token cap (e.g. 10k total) — allocate budget per phase, verify the most critical part first, and degrade gracefully when the cap nears. Use when asked to 'giới hạn token', 'làm trong 10k token', 'token cap cho task này', 'budget workflow', 'tiết kiệm chi phí cho task', 'cheap mode', or 'work within a token limit'. Do NOT use for: choosing response length/depth — see token-budget-advisor. Do NOT use for: auditing context window bloat — see context-budget. Do NOT use for: cost-per-value scoring — see token-roi." tier: TIER 4 — TOKEN OPTIMIZATION source: yana-ai (anh Tâm prompt pack, 2026-06-10) --- # Token-Capped Workflow — Làm việc trong hạn mức token Giới hạn tổng chi phí token cho một tác vụ cụ thể, ép ưu tiên kiểm chứng phần quan trọng nhất trước, và xuống cấp có kiểm soát khi gần chạm trần. > Prompt gốc: *"Tạo workflow cho task này, nhưng giới hạn tổng chi phí ở > khoảng 10k token, ưu tiên kiểm chứng phần quan trọng nhất trước."* --- ## Khi nào dùng - Task lặp lại nhiều lần (batch) — tiết kiệm nhân theo số lần chạy - Session sắp cạn budget nhưng việc chưa xong - Task exploratory chưa chắc đáng đầu tư — cap thấp để thăm dò - Chạy trên backup stack có quota chặt (Groq/Gemini free tier) ## Phân bổ chuẩn cho cap 10k ``` ┌──────────────────────────────────────────────┐ │ 1. SCOPE ~10% (1k) — đọc đề, chốt phạm vi│ │ 2. VERIFY-CORE ~30% (3k) — kiểm phần QUAN TRỌNG │ │ NHẤT trước tiên │ │ 3. EXECUTE ~40% (4k) — làm phần chính │ │ 4. CHECK ~15% (1.5k)— verify kết quả │ │ 5. RESERVE ~5% (0.5k)— dự phòng lỗi │ └──────────────────────────────────────────────┘ ``` **Verify-first là bắt buộc:** phần quan trọng nhất phải được kiểm chứng TRƯỚC khi tiêu token vào phần phụ. Hết budget giữa chừng mà core đã verify = vẫn có giá trị. Hết budget mà core chưa check = công cốc. ## Kỹ thuật tiết kiệm theo bước | Bước | Kỹ thuật | |------|----------| | Đọc file | Read có `offset/limit`, grep trước đọc sau — không đọc cả file | | Search | Grep với pattern hẹp, `head_limit` — không dump cả output | | Sinh code | Diff/edit thay vì viết lại cả file | | Báo cáo | Bullet ngắn, bỏ giải thích lặp — kết quả trước, lý do 1 câu | | Lặp | Không re-read file vừa edit; không re-run lệnh đã có kết quả | ## Checkpoint trần ``` 50% cap — tự hỏi: core đã verify chưa? Chưa → dừng EXECUTE, quay lại VERIFY 80% cap — chỉ còn được: hoàn thiện + báo cáo. Không mở thêm phạm vi mới 100% cap — DỪNG. Báo: đã làm gì, còn gì, cần thêm bao nhiêu token để xong ``` Vượt cap không xin phép = vi phạm. Báo trước, đợi quyết định. ## Format khai báo đầu task ```markdown ## Token Plan — Cap: 10k | Core cần verify trước: Phân bổ: scope 1k · verify 3k · execute 4k · check 1.5k · reserve 0.5k Ngoài phạm vi (không tiêu token): ``` ## Anti-Fake-Pass ``` ❌ Nhận cap nhưng không khai báo Token Plan trước khi làm ❌ "Ước lượng" token bằng cảm giác sau khi đã vượt — checkpoint phải diễn ra TẠI 50%/80%, không phải hồi tưởng cuối task ❌ Hết budget rồi im lặng bỏ bước CHECK — phải báo rõ bước nào bị cắt ❌ Verify phần dễ trước (cho nhanh) thay vì phần quan trọng nhất ❌ Lách cap bằng cách tách thành nhiều request nhỏ không khai báo (vi phạm 60-token-budget-velocity-law) ``` ## See also - `token-budget-advisor` — chọn độ sâu câu trả lời theo ý user - `context-budget` — audit context window bị phình do components - `token-roi` — tính ROI trước khi nhận task đắt - `token-budget-policy.md` / `60-token-budget-velocity-law.md` — luật cứng