Templates Và Starter Artifacts

Pack này biến tài liệu thành toolkit có thể dùng ngay. Dùng các template làm điểm bắt đầu cho issue, pull request, architecture note, AI-DLC record hoặc agent prompt.

Templates có thể tải

Template	Dùng khi	Link
Spec Kit feature spec	Intent còn mơ hồ và cần spec-first path	Download
OpenSpec change proposal	Cần lightweight SDD cho change có scope rõ	Download
AI-DLC risk and audit record	Delivery cần governance, review và traceability	Download
GSD phase plan	Công việc kéo dài nhiều session, agent hoặc handoff	Download
Superpowers TDD prompt	Muốn coding agent design, test, implement, review	Download
LangGraph state design	Đang build stateful agent service	Download
RAG eval checklist	Cần release gate cho RAG production	Download
Tool permission matrix	Cần safe tool use, audit và approval rules	Download
Adoption scorecard	Cần đánh giá maturity và ưu tiên cải tiến	Download

Template nào nên bắt buộc?

flowchart TB
    A[New AI-assisted change] --> B{Risk level}
    B -->|High| C[AI-DLC risk and audit record]
    B -->|Medium| D{Requirement clarity}
    B -->|Low| E[OpenSpec change proposal]
    D -->|Unclear| F[Spec Kit feature spec]
    D -->|Clear| E
    C --> G[Tool permission matrix]
    F --> H[Superpowers TDD prompt]
    E --> H
    G --> I[RAG eval hoặc LangGraph state design nếu liên quan]
    H --> I

Bundle tối thiểu khuyến nghị

Scenario	Templates cần có
Product feature bình thường	Spec Kit feature spec hoặc OpenSpec proposal, Superpowers TDD prompt
RAG feature	OpenSpec proposal, RAG eval checklist, tool permission matrix
Stateful agent	LangGraph state design, tool permission matrix, eval checklist
Enterprise AI feature	AI-DLC risk/audit record, spec, tool permission matrix, release evidence
Internal agent platform	AI-DLC record, Hermes/tool policy notes, LangGraph state design nếu có app runtime

Dùng với coding agent như thế nào

1. Điền template nhỏ nhất đủ phản ánh risk.
2. Paste artifact đã điền vào issue, PR hoặc agent session.
3. Nói rõ artifact nào là source of truth.
4. Yêu cầu agent tạo plan map từng task về artifact đó.
5. Bắt buộc có test, eval hoặc review evidence trước khi coi implementation là xong.

Quality bar của template

Template chỉ hữu ích nếu nó thay đổi hành vi. Nếu một section không ảnh hưởng đến design, testing, review hoặc release, hãy bỏ nó cho change đó. Lightweight không có nghĩa là không tài liệu; nó nghĩa là artifact nào cũng phải có lý do tồn tại.