flow-trace-genesislisted

Lần đầu tiếp cận một project CHƯA có skill flow-trace local — khảo sát codebase (Evidence/Candidate/Ingest tier) rồi SINH skill flow-trace local self-contained cho project đó (CORE + PROFILE, version stamp, golden-flow gate Draft→Verified). Skill sinh ra biến flow trong code thành cẩm nang từ tech đến business — tóm tắt nghiệp vụ, validation rules, business spec ngược, failure modes — cho cả dev lẫn BA/PO/PM/QA. Dùng khi user gọi /flow-trace-genesis, muốn "dạy AI trace flow project này", muốn "tài liệu hoá quy trình từ code cho cả team", hoặc muốn regenerate CORE của flow-trace đã sinh. KHÔNG dùng khi project đã có flow-trace local và user chỉ muốn trace — khi đó dùng chính skill local.
mthang1801/flow-trace-genesis · ★ 1 · Data & Documents · score 75

Install: claude install-skill mthang1801/flow-trace-genesis

# Flow-Trace Genesis — sinh skill flow-trace cho project lạ Sản phẩm cuối **không phải bản trace**, mà là **một skill `flow-trace` local** nằm trong project đích: tự đứng được (self-contained), đúng convention project, kèm bộ render md-source → HTML, và chỉ được coi là xong khi qua golden-flow gate. Cẩm nang skill đó sinh ra phục vụ **cả team, không riêng dev**: tóm tắt nghiệp vụ ngôn ngữ thường + business spec ngược cho BA/PO/PM, validation rules + failure modes cho QA, bảng bước `file:line` + diagram cho kỹ sư. ## Nguyên tắc sản phẩm (bất biến — trùng `.agents/AGENTS.md` repo này) 1. **Evidence tier**: chỉ nội dung đã Read với `file:line` được thành citation trong PROFILE và trong mọi bản trace. Candidate tier (GitNexus/DeepWiki/Understand-Anything/ GitDiagram) chỉ gợi ý. Ingest tier (MarkItDown/Docling) chỉ convert tài liệu. 2. **CORE/PROFILE**: CORE từ `references/core-template.md` — ghi đè được khi regenerate; PROFILE từ questionnaire — regenerate PHẢI bảo toàn. 3. **Degrade gracefully**: máy thiếu tool nào thì ghi rõ và đi tiếp bằng grep + Read, không chặn việc, không giả vờ tool đã chạy. 4. **Không ghi đè**: project đã có flow-trace local → chỉ regenerate sau khi show diff CORE cũ/mới và user confirm; không confirm thì dừng. ## Playbook 6 bước (mỗi bước có gate — không nhảy cóc) ### Bước 1 — Intake & guard - Nhận `TARGET_DIR` (bắt buộc), `PRD`/`ADVISOR` (tùy chọn). - Dò skill flow-trace local có sẵn: `.agents/skills/flow-trace/`, `.claude/skills/