v2.0.1 — sửa bug MCP probe-verified + bổ sung SOP

Rà soát skill pack đối chiếu trực tiếp MCP server FARE thật (probe live). Sửa bug status/actual_effort/add_comment (fail -32602), chip-mention thân doc, SRS template, glossary dedup, thuật ngữ module→plan item, ranh giới vai. Bổ sung skill fare-tech-doc-authoring + nhánh greenfield + tiền điều kiện project + cảnh báo cohesion. Chi tiết: CHANGELOG [2.0.1].

v2.0.0 — Plan-item model + plan_item_id rename

BREAKING: đồng bộ với API MCP FARE bản mới — bỏ mô hình Module/Epic đời cũ, đổi tên param module_id → plan_item_id. Skill/prompt pin theo tên tool hoặc param cũ cần cập nhật.

Changed

• Đổi tên param module_id → plan_item_id (module_ids → plan_item_ids); field trả về module_name → plan_item_name, output module → plan_item. Đồng bộ với hard rename trên MCP server (DB column nội bộ giữ nguyên, handler dịch param↔column).
• Bỏ mô hình Module/Submodule/Function + Epic-initiative đời cũ → WBS là plan item theme › epic › story (3 cấp). Skill gọi tool đã gỡ (add_module/create_epic/get_plan/get_test_case/create_task số ít…) được viết lại theo bộ tool thật server expose.
• fare-mcp-integration trở thành HỢP ĐỒNG tool canonical duy nhất (manifest 40 tool + mô hình effort). Mọi skill khác trỏ về đây cho chữ ký tool.
• bin/check-tools.mjs — linter chống tái drift (CANONICAL/DEPRECATED/REMOVED), wire vào sync:claude + prepack.
• Thêm skill + workflow fare-plan-review (chấm chất lượng cây theme/epic/story).

Cài đặt

npx fare-skill-pack@2.0.0

🤖 Generated with Claude Code

v1.0.2

[1.0.2] — 2026-05-26

Changed

• init không còn prompt MCP endpoint / API key / scope. Trách nhiệm đăng ký MCP tách sang register-mcp command riêng. init giờ chỉ sao chép .agent/ vào target và in next-steps hint.
• README rewrite theo văn phong factual, lược bỏ phrasing mang tính marketing / tự sự.

v1.0.0 — Initial release

[1.0.0] — 2026-05-25

Initial release — bộ skill Antigravity / Claude Code đầu tiên vận hành FARE qua MCP. Phủ trọn vòng đời requirements → design → dev → testing với 4 vai chính + 2 vai phụ trợ.

Added

6 Agent

• fare-business-analyst — phân tích yêu cầu, viết & tách spec, chia cây module, traceability, change request.
• fare-project-manager — chia function thành task, FP effort analysis, plan versioning, backlog grooming, epic management.
• fare-qa-engineer — viết test case từ AC (ISTQB), verify_history atomic, bug reporting theo §5.
• fare-developer — pickup task, impact analysis qua code intelligence, self-verify & handoff. KHÔNG tự code (rule §8).
• fare-technical-writer — viết tài liệu kỹ thuật (api_doc, erd, diagram, specification).
• fare-spec-reviewer — soát spec 6 lăng kính (Data Integrity, Unhappy Paths, Security, Usability, Testability, UI/UX vs Figma).

22 Skill — chia thành 4 nhóm:

• Chung (2): fare-context-discovery, fare-mcp-integration.
• BA (6): fare-spec-authoring, fare-doc-split, fare-doc-normalize, fare-plan-breakdown, fare-traceability, fare-change-request.
• PM (5): fare-task-breakdown, fare-effort-estimation, fare-plan-versioning, fare-backlog-grooming, fare-epic-management.
• QA (3): fare-test-authoring, fare-test-execution, fare-bug-reporting.
• Dev (3): fare-task-pickup, fare-impact-analysis, fare-self-verify.
• Tiện ích (3): docx, pdf, xlsx (đọc file đầu vào).

16 Workflow (slash-command)

• BA: /fare-ba, /fare-plan, /fare-trace, /fare-change.
• PM: /fare-pm, /fare-breakdown, /fare-groom, /fare-epic.
• QA: /fare-qa, /fare-test, /fare-verify.
• Dev: /fare-dev, /fare-impact, /fare-handoff.
• Khác: /fare-write-doc, /fare-audit-spec.

3 Rule always-on

• fare-rules.md — 9 quy tắc bất khả xâm phạm khi gọi MCP (Hierarchy Strictness, Confirmation Gate, Context First, Tool Optimization, Socratic Gate, Task Lifecycle 4-state, Content Fidelity, MCP-only, Brief Response).
• operating-mode.md — 2 chế độ vận hành (Substitute / Assistant).
• GEMINI.md — entry point thứ tự đọc đầu phiên.

Đặc tính nổi bật

• Bottom-up est_effort — ước task theo bản chất task (2 chiều: AI level × Dev level), KHÔNG chia từ function. Ceiling check 6-tier theo sum / (function.effort_est × hours_per_day).
• Epic dimension — initiative cross-module gom task qua epic_id. Phân biệt rõ Epic ≠ Module ≠ Campaign ≠ Plan.
• Confirmation Gate (§2) — mọi action thay đổi dữ liệu trên FARE đều phải User chốt trước. Cấm gộp nhiều quyết định quan trọng vào 1 lệnh.
• Bug discovery §5 — agent KHÔNG tự create_tasks(type=BUG). Phải báo Markdown + hỏi User + chờ chốt.
• Task lifecycle §6 — 4-state cứng TODO → IN_PROGRESS → VERIFYING → DONE. KHÔNG skip; DONE cần evidence verify.
• Content Fidelity §7 — KHÔNG bịa, KHÔNG tự duyệt (approved/archived), KHÔNG tự publish plan version.
• MCP-only §8 — agent chỉ thao tác qua MCP, không truy cập file ngoài workspace .agent/.

CLI tool fare-skill (zero deps, Node stdlib)

• init [target] — copy .agent/ vào workspace + in lệnh claude mcp add (KHÔNG tự exec để giữ secret an toàn).
• update [target] — backup .agent/ hiện tại + overwrite với version mới.
• uninstall [target] — confirm + xóa .agent/.
• register-mcp — chỉ in lệnh đăng ký MCP (cho workspace đã có .agent/).
• help, version.

Yêu cầu FARE backend (đi kèm với v1.0.0 của skill pack — cần FARE backend tương thích):

• Resource fare://projects/{code} trả thêm field hours_per_day (đọc qua configurations table, key working_hours_config global hoặc per-project working_hours_config:project:{id}, default 8).
• Resource mới fare://modules/{id}/task-effort-summary — sum est/actual, breakdown by type + meta_status, ratio_actual_est_done.
• Resource mới fare://projects/{code}/velocity — median(actual/est) cho task DONE qua 3 cửa sổ 30/60/90d, breakdown by type, dùng Postgres PERCENTILE_CONT.

Installation

# Cách 1 — qua npm registry (sau khi publish)
npx fare-skill-pack init

# Cách 2 — install thẳng từ GitHub (không cần npm publish)
npx github:bacng95/fare-skill-pack init

# Pin theo tag
npx github:bacng95/fare-skill-pack#v1.0.0 init

Notes

• Bộ skill thiết kế cho dev đỡ vai các chuyên gia (Substitute mode mặc định). Nếu workspace có BA/PM/QA/Dev thật → chế độ Assistant.
• Không phụ thuộc external npm package nào ngoài Node stdlib.
• Tương thích Antigravity và Claude Code.