Plans

# Plan: Thêm Skill /supergraph:sdd (Software Design Document)
Review: Approved

## Task 1: Tạo skill /supergraph:sdd
Status: completed
Risk: low
Dependencies: none

Files:
- Create: plugins/supergraph/skills/sdd/SKILL.md

Blast radius:
- plugins/supergraph/skills/sdd/SKILL.md

Acceptance:
- [ ] File `plugins/supergraph/skills/sdd/SKILL.md` tồn tại với YAML frontmatter hợp lệ
- [ ] Hướng dẫn trích xuất context từ `CONTEXT.md` và `codebase-memory-mcp` (`get_architecture`)
- [ ] Định dạng output chuẩn tại `docs/supergraph/sdd/YYYY-MM-DD-sdd-<slug>.md` gồm 6 phần: Context & Scope, Component & Flow Architecture (Mermaid), Interface & Data Contracts, Platform Compatibility Matrix, Failure Modes & Fallbacks, ADRs
- [ ] Có User Approval Gate trước khi chuyển sang `/supergraph:plan`

TDD:
- Behavior: skill sdd file exists và có cấu trúc hợp lệ
- Test file: plugins/supergraph/tests/test-documentation-consistency.sh
- Test name: sdd skill discovery
- 🔴 RED command: `test -f plugins/supergraph/skills/sdd/SKILL.md`
- Expected 🔴 RED failure: exit code 1 (file not found)
- Minimal 🟢 GREEN change: tạo `plugins/supergraph/skills/sdd/SKILL.md` với đầy đủ các section
- Refactor candidates: none
- Mocking: none

Steps:
1. 🔴 RED: `test -f plugins/supergraph/skills/sdd/SKILL.md` → fail
   Command: `test -f plugins/supergraph/skills/sdd/SKILL.md`
   Expected: FAIL
2. 🟢 GREEN: tạo file `plugins/supergraph/skills/sdd/SKILL.md`
   Command: `test -f plugins/supergraph/skills/sdd/SKILL.md`
   Expected: PASS
3. REFACTOR: format markdown chuẩn, link đầy đủ
4. VERIFY:
   - `test -f plugins/supergraph/skills/sdd/SKILL.md`

Checkpoint:
- Files: `plugins/supergraph/skills/sdd/SKILL.md`
- Commit: `feat(skills): add /supergraph:sdd for software design document and contract specs`

## Task 2: Cập nhật tài liệu quy trình tích hợp SDD
Status: completed
Risk: low
Dependencies: Task 1

Files:
- Modify: AGENTS.md
- Modify: plugins/supergraph/AGENTS.md
- Modify: plugins/supergraph/CLAUDE.md
- Modify: OPENCODE.md
- Modify: plugins/supergraph/OPENCODE.md

Blast radius:
- AGENTS.md
- plugins/supergraph/AGENTS.md
- plugins/supergraph/CLAUDE.md
- OPENCODE.md
- plugins/supergraph/OPENCODE.md

Acceptance:
- [ ] Bảng Skills trong `AGENTS.md` và `CLAUDE.md` có dòng `/supergraph:sdd`
- [ ] Tiered Workflow bảng Tier 3 (Full Pipeline) cập nhật: `scan → analyze → sdd → plan → execute → fix → integration → verify → review`
- [ ] `OPENCODE.md` liệt kê `/sdd`

TDD:
- Behavior: AGENTS.md và OPENCODE.md có đề cập tới sdd
- Test file: plugins/supergraph/tests/test-documentation-consistency.sh
- Test name: sdd mentioned in workflows
- 🔴 RED command: `grep -c "supergraph:sdd" AGENTS.md`
- Expected 🔴 RED failure: 0
- Minimal 🟢 GREEN change: thêm dòng `/supergraph:sdd` vào bảng kỹ năng và quy trình Full Pipeline
- Refactor candidates: đồng bộ chính xác giữa root và `plugins/supergraph/`
- Mocking: none

Steps:
1. 🔴 RED: `grep "supergraph:sdd" AGENTS.md` → 0
   Command: `grep -c "supergraph:sdd" AGENTS.md`
   Expected: FAIL (0)
2. 🟢 GREEN: thêm `/supergraph:sdd` vào bảng Skills & Tier 3 Full Pipeline
   Command: `grep -c "supergraph:sdd" AGENTS.md`
   Expected: PASS (>0)
3. REFACTOR: đồng bộ root với `plugins/supergraph/`
4. VERIFY:
   - `bash plugins/supergraph/tests/test-documentation-consistency.sh`

Checkpoint:
- Files: `AGENTS.md plugins/supergraph/AGENTS.md plugins/supergraph/CLAUDE.md OPENCODE.md plugins/supergraph/OPENCODE.md`
- Commit: `docs: integrate /supergraph:sdd into workflow tables and full pipeline`

## Task 3: Bổ sung keyword hint cho SDD trong hooks
Status: completed
Risk: low
Dependencies: Task 2

Files:
- Modify: plugins/supergraph/hooks/user-prompt-submit
- Modify: plugins/supergraph/hooks/pre-invocation
- Modify: plugins/supergraph/hooks/session-start
- Modify: plugins/supergraph/.opencode-plugin/plugin.ts

Blast radius:
- plugins/supergraph/hooks/user-prompt-submit
- plugins/supergraph/hooks/pre-invocation
- plugins/supergraph/hooks/session-start
- plugins/supergraph/.opencode-plugin/plugin.ts

Acceptance:
- [ ] `hooks/user-prompt-submit` có regex phát hiện keyword `sdd|design doc|software design|system design|data contract|api spec|interface contract` → hint `/supergraph:sdd`
- [ ] `hooks/pre-invocation` có regex tương tự cho Antigravity
- [ ] `hooks/session-start` liệt kê `/supergraph:sdd` trong danh sách skills mới
- [ ] `plugin.ts` của OpenCode có keyword hint `sdd`
- [ ] Toàn bộ test hook contracts PASS

TDD:
- Behavior: prompt chứa "sdd" hoặc "design doc" kích hoạt gợi ý
- Test file: plugins/supergraph/tests/test-hook-contracts.sh
- Test name: sdd keyword hint hook
- 🔴 RED command: `grep -c "supergraph:sdd" plugins/supergraph/hooks/user-prompt-submit`
- Expected 🔴 RED failure: 0
- Minimal 🟢 GREEN change: thêm block keyword hint cho `sdd`
- Refactor candidates: none
- Mocking: none

Steps:
1. 🔴 RED: `grep -c "supergraph:sdd" plugins/supergraph/hooks/user-prompt-submit` → 0
   Command: `grep -c "supergraph:sdd" plugins/supergraph/hooks/user-prompt-submit`
   Expected: FAIL (0)
2. 🟢 GREEN: cập nhật các hook với keyword hint sdd
   Command: `grep -c "supergraph:sdd" plugins/supergraph/hooks/user-prompt-submit`
   Expected: PASS (>0)
3. REFACTOR: đảm bảo JSON formatting hợp lệ
4. VERIFY:
   - `for test_file in plugins/supergraph/tests/test-*.sh; do bash "$test_file"; done`
   - `bash -n plugins/supergraph/hooks/user-prompt-submit plugins/supergraph/hooks/session-start`

Checkpoint:
- Files: `plugins/supergraph/hooks/user-prompt-submit plugins/supergraph/hooks/pre-invocation plugins/supergraph/hooks/session-start plugins/supergraph/.opencode-plugin/plugin.ts`
- Commit: `feat(hooks): add /supergraph:sdd keyword hints and session-start announcement`

## Environment Context
- **Language:** Bash 3.2 + Markdown + Python 3 + TypeScript
- **Test command:** `for test_file in plugins/supergraph/tests/test-*.sh; do bash "$test_file"; done`
- **Linter command:** `bash -n plugins/supergraph/install.sh plugins/supergraph/tests/test-*.sh`
- **Formatter command:** not configured
- **Build command:** not configured
- **Branch:** master
- **Conventional commit style:** `feat:`, `docs:`, `refactor:`

**Codebase conventions:** Hooks emit JSON object; skills include frontmatter name + description; docs keep bilingual or consistent structure.

**Graph Context:**
- Blast radius: 10 files (1 skill, 5 doc files, 4 hook files)
- Hub nodes: none
- Bridge nodes: none
- Communities crossed: none