@haposoft/cafekit 0.7.14 → 0.7.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haposoft/cafekit",
-  "version": "0.7.14",
+  "version": "0.7.15",
   "description": "Spec-Driven Development workflow for AI coding assistants. Supports Claude Code and Antigravity with spec-first workflows plus Claude Code hapo: skills.",
   "author": "Haposoft <nghialt@haposoft.com>",
   "license": "MIT",

package/src/claude/skills/specs/rules/tasks-generation.md

@@ -11,13 +11,17 @@ Focus on capabilities and outcomes, not code structure.
 - Features and capabilities
 - Domain language and concepts
 - Data relationships and workflows
-**Required (Code-Level Implementation Style)**:
-- File paths and specific UI components
-- Database tables, columns, and Zod/Type schemas
-- API payloads, routes, and JSON contracts
-- Edge cases, error handling, and exact validation thresholds
-
-**Rationale**: AI Coders (like god-developer or ck) consume these tasks directly. If a sub-task is written like PM business jargon (e.g., "Define pass thresholds") instead of code-level instructions (e.g., "Implement `gap_ratio < 15%` threshold in `evaluator.ts`"), the AI coder will hallucinate or fail. Tasks are not PRDs; they are explicit coding orders.
+**Required (Hybrid Human-AI Style)**:
+Every sub-task MUST balance Human Intent (for PM review) and Code-Level Details (for AI implementation).
+Detail bullets must include:
+1. **Human Intent (The "Why")**: Briefly explain the business logic, expected UX behavior, or why this code exists (e.g., "Mục đích: Chặn user sử dụng extension nếu chưa đồng ý Privacy").
+2. **AI Code-Level Details (The "How")**:
+   - File paths and specific UI components to create/modify.
+   - Database tables, columns, and Zod/Type schemas (e.g., `Update users.consent_version`).
+   - API payloads, routes, and JSON contracts.
+   - Edge cases, error handling, and exact validation thresholds (e.g., `Return 403 if invalid`).
+
+**Rationale**: Humans review tasks to verify business requirements are met; AI Coders (like god-developer or ck) read tasks to write explicit code. If you only write business jargon, the AI hallucinates. If you only write code names, the human reviewer cannot verify the business value. You MUST provide both.
 
 ### 2. Task Integration & Progression