sdd-rfc
Quản lý RFC để sửa CONSTITUTION.md hoặc thay đổi kiến trúc lớn
SKILL.md.claude/skills/sdd-rfc/SKILL.md
GitHubSDD RFC Manager (/sdd-rfc)
Output language: All output mirrors the language of the invoking prompt. Vietnamese prompt → Vietnamese output; English prompt → English output. Canonical tokens (PROPOSED, APPROVED, PENDING HUMAN REVIEW), RFC identifiers (RFC-XXX), rule codes, file paths, and CLI commands are language-invariant.
Dùng khi cần đề xuất thay đổi/bổ sung quy tắc trong CONSTITUTION.md thuộc Layer 1 Hard Rules hoặc Layer 2 Architectural Constraints sau khi template đã phát hành. Một explicit Human authorization cho một đợt phát hành template không tạo quyền mặc định cho Agent sửa Constitution.
Tham số
--title=<short-title>: Tiêu đề ngắn, ví dụsoft-delete-policyhoặcjwt-expiry-standard.--approve=<rfc-number>: Chỉ Tech Lead/Human Director được dùng để phê duyệt RFC và đồng bộ Constitution.
Quy trình
- Tạo RFC
- Không truyền
--approve: tạo.sdd/rfcs/RFC-XXX-<title>.md, đánh số liên tụcRFC-001,RFC-002, ... và status ban đầuPROPOSED.
- Không truyền
- Điền template RFC
- Bắt buộc có
Motivation,Proposed Change,Risk AssessmentvàMigration Plan. - Quy tắc mới dùng code
SEC-XX,DATA-XX,ARCH-XXhoặcENG-XXkhi phù hợp.
- Bắt buộc có
- Phê duyệt và đồng bộ
- Chỉ RFC đã
APPROVEDbởi Tech Lead/Human Director mới được đồng bộ vàoCONSTITUTION.md. - Bump patch/minor version của Constitution theo semantic impact.
- Chỉ RFC đã
AI Recommendation và Human Final Review
Sau khi soạn hoặc đánh giá RFC, tạo canonical recommendation từ .claude/skills/_shared/ai-review-protocol.md, gồm motivation, alternative, security/architecture impact, migration risk và disposition đề xuất. Lưu trong RFC hoặc .sdd/reviews/rfc-<number>.md với PENDING HUMAN REVIEW. Chỉ Tech Lead/Human Director được ủy quyền có thể approve RFC và thay đổi Constitution; Agent không tự approve.
Hướng dẫn sử dụng
- Khi dùng: Propose or authorizedly approve a Constitution Layer 1/2 or major architecture change.
- Không dùng: Không dùng để approve feature artifacts, patch source directly, or substitute
/sdd-reviewfor RFC approval. - Input:
--titlecreates a proposal;--approve=<RFC-XXX>is restricted to authorized Tech Lead/Human Director; reject missing migration/risk evidence. - Điều kiện trước: Constitution and existing RFC sequence are readable; approval authority must be explicit and persisted by project governance.
- Evidence: RFC file with motivation/change/risk/migration, recommendation block, status and Constitution version impact.
- Dừng khi: Missing authority, conflicting rule, incomplete migration/risk, invalid RFC ID or attempted direct Constitution write.
- Human quyết định: Authorized Tech Lead/Human Director approves RFC; Agent never self-approves or treats template authorization as ongoing authority.
- Lệnh tiếp theo:
/sdd-rfc --approve=<rfc-number>only when authorized; then follow the RFC's persisted sync action. - Ví dụ:
/sdd-rfc --title=soft-delete-policycreatesPROPOSEDRFC without changingCONSTITUTION.md.
Completion output
Dùng Completion output contract. Nêu RFC ID/status, Constitution/migration impact, evidence và review target. RFC PROPOSED là Human decision required; chỉ Tech Lead/Human Director được ủy quyền mới có thể chạy /sdd-rfc --approve=<rfc-number>. Thiếu authority, motivation/risk/migration hoặc conflicting rule là BLOCKED; không dùng /sdd-review để thay route approve RFC.