flow-tracelisted

Trace end-to-end business flow trong grpc-go (google.golang.org/grpc) từ 1 file/hàm/tên flow được chỉ định. Dùng khi user gọi /flow-trace, hỏi "flow này đi qua đâu", "ai gọi hàm này", "vẽ diagram flow X", hoặc cần cẩm nang business/validation/failure-mode cho một luồng trong thư viện. Output persist tại docs/flows/<slug>/ (md-source đa section + _doc.yml), render HTML bằng render/build.py.
mthang1801/flow-trace-genesis · ★ 1 · Data & Documents · score 72

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

# Flow Trace — Cẩm nang trace flow (grpc-go) Input: đường dẫn 1 file (public API / handler / internal component) **hoặc** tên flow. Output: **một cẩm nang md-source** tại `docs/flows/<slug>/` (`_doc.yml` menu + mỗi section một file `NN-slug.md`, nội dung theo `references/report-template.md`). Skill này **read-only với source code**. Chỉ ghi vào `docs/flows/<slug>/` (+ `docs/flows/<slug>.html` khi build).  ## Nguyên tắc bất biến (đọc trước khi làm gì khác) 1. **Không có node nào thiếu bằng chứng.** Một node/edge chỉ được ghi vào báo cáo khi bạn đã `Read` file chứa nó trong phiên này và ghi được `file:line`. Kết quả grep/tool index chưa phải bằng chứng — chúng chỉ để tìm ứng viên, Read để xác nhận. 2. **Không resolve được thì nói thẳng.** Mọi liên kết không lần ra được phải vào mục **"Chưa xác định"** của báo cáo. Cấm đoán rồi trình bày như fact. 3. **Phân định 2 loại nội dung.** Phần flow/validation là *deterministic* (đọc code ra). Phần business/security/ops là *suy luận* — bắt buộc gắn nhãn `[AI suy luận — cần domain owner xác nhận]` và vẫn phải kèm citation `file:line` cho căn cứ. 4. **Nhánh chính trước.** Trace hết happy path end-to-end trước, rồi mới mở nhánh lỗi/nhánh phụ. Nhánh chưa mở rộng → liệt kê ở mục "Nhánh chưa trace" thay vì trace nửa vời. 5