td

Post-Task Review & Retrospective

สร้าง retrospective พร้อม Before/After context และบันทึก session

Usage

/td           # ถามว่างานเสร็จหรือยัง
/td done      # งานเสร็จแล้ว
/td pending   # ยังไม่เสร็จ รอทำต่อ
/td blocked   # ติดปัญหา

Output

$PROJECT_ROOT/kb/05-ai-reviewed/retrospective/YYYY-MM/retrospective_YYYY-MM-DD_hhmmss.md

Flow

/td → Determine Status → Auto-capture → Gather Info → Comment Issue → Create Retrospective → Promote to KB (if done+ticket) → Update Focus → Commit Docs → Confirm

Note: สำหรับ tests, build, code review และสร้าง PR ให้ใช้ /pr ก่อนรัน /td

Instructions

Language Setting

Check LANGUAGE in docs/current.md. If th, translate output per references/language-guide.md. See references/bash-helpers.md for detection snippet.

Step 0: Read Current Focus

export TZ='Asia/Bangkok'
echo "=== Current Focus ==="
cat docs/current.md

เก็บค่า TASK และ ISSUE ไว้ใช้ใน steps ถัดไป

Step 1: Determine Completion Status

ถ้าไม่มี argument (/td):

งานเสร็จหรือยัง?

1. เสร็จแล้ว (done)      → STATE = completed
2. ยังไม่เสร็จ (pending)  → STATE = pending
3. ติดปัญหา (blocked)    → STATE = blocked

ถ้ามี argument:

• /td done → STATE = completed
• /td pending → STATE = pending
• /td blocked → STATE = blocked

Step 2: Auto-capture Git Context

export TZ='Asia/Bangkok'
echo "Date: $(date '+%Y-%m-%d')"
echo "Time: $(date '+%H:%M:%S')"
echo "Branch: $(git branch --show-current)"

echo "=== Changed Files ==="
git diff --name-only HEAD

echo "=== Staged Files ==="
git diff --cached --name-only

echo "=== Recent Commits (last 4 hours) ==="
git log --oneline -10 --since="4 hours ago"

echo "=== Status ==="
git status --short

Step 3: Gather Session Info from User

ใช้ AskUserQuestion เพื่อรวบรวมข้อมูล:

1. Tasks Done: รายละเอียดงานที่ทำไป
2. Test Status: ผ่าน/ไม่ผ่าน (หรือใช้ /pr แล้วหรือยัง)
3. Test Details: รายละเอียดการทดสอบ
4. Errors: ข้อผิดพลาด (ถ้ามี)
5. Additional Notes: ข้อมูลเพิ่มเติม

Step 4: Add Comment to Issue

อ่าน issue number จาก docs/current.md:

ISSUE=$(grep "^ISSUE:" docs/current.md | cut -d: -f2 | tr -d ' #')
echo "Issue: #$ISSUE"

Auto-assign issue (ensure user is assigned):

gh issue edit "$ISSUE" --add-assignee @me 2>/dev/null || true

เพิ่ม comment ใน issue:

export TZ='Asia/Bangkok'

gh issue comment $ISSUE --body "$(cat <<EOF
## Session Summary

### Tasks Done

[user input - รายละเอียดงานที่ทำ]

### Test Results

| Test | Status |
|------|--------|
| Acceptance Criteria | [user input] |

### Test Details

[user input - รายละเอียดการทดสอบ]

### Errors (if any)

[user input - ข้อผิดพลาด หรือ "None"]

### Additional Notes

[user input - ข้อมูลเพิ่มเติม]

---

*Session: $(date '+%Y-%m-%d %H:%M')*
EOF
)"

Step 5: Create Retrospective File

สร้างไฟล์ kb/05-ai-reviewed/retrospective/YYYY-MM/retrospective_YYYY-MM-DD_hhmmss.md

(ใช้ template ด้านล่าง)

Step 5.5: Promote to KB (canonical)

Gate: ทำเฉพาะเมื่อ STATE = completed เท่านั้น. ถ้า pending/blocked → ข้าม (working note ค้างใน kb/00-inbox/ ต่อ ไว้ promote ตอนเสร็จจริง) เฉพาะงานที่มี RUAYS ticket. ถ้า ticketless (เช่น ad-hoc/exploration, ISSUE ว่าง/-) → ข้าม (retro ใน 05-ai-reviewed/ พอแล้ว — promote เข้า 01-projects ทำเฉพาะงานที่ผูก ticket) นี่เป็น judgment step — Claude ทำเอง (อ่าน → จัดหมวด → เขียน). อ้างอิง [[PLAYBOOK]] Mode B + C

5.5.1 — รวบรวม source:

ISSUE=$(grep "^ISSUE:" docs/current.md | cut -d: -f2 | tr -d ' #')
echo "=== inbox working note (breadcrumb จาก SessionEnd hook) ==="
ls kb/00-inbox/*"$ISSUE"*.md 2>/dev/null
echo "=== retrospective ที่เพิ่งสร้าง ==="
ls -t kb/05-ai-reviewed/retrospective/*/retrospective_*.md 2>/dev/null | head -1

อ่าน inbox note + retrospective ล่าสุด + git diff เป็นวัตถุดิบ

5.5.2 — หา primary owner service (heart of change / ที่ endpoint อยู่ — ดู VAULT-CONVENTIONS multi-repo rule) จาก service: ใน inbox frontmatter หรือเดาจากไฟล์ที่แก้

5.5.3 — เขียน/อัปเดต feature folder kb/01-projects/<service>/RUAYS-XXXX/:

• MOC RUAYS-XXXX - <slug>.md (ขึ้นต้นด้วย ? Status & Next, frontmatter ครบ: project/jira/service/status/type)
• Retrospective.md — สรุปจาก retro ที่เพิ่งสร้าง
• อัปเดต service MOC <service>.md (ตาราง Active Work → ย้ายแถวไป Done)

5.5.4 — กระจาย learning ตามชนิด (อันไหนไม่มีก็ข้าม):

ชนิด	ปลายทาง
pattern ใช้ซ้ำ ≥ 2 services	kb/02-patterns/<domain>/<Name>.md
bug/incident production	kb/03-bugs/YYYY-MM-DD <system> - <title>.md
architecture decision	kb/04-decisions/ADR-NNN-<slug>.md
retro/analysis reusable	kb/05-ai-reviewed/...

ใช้ [[wiki-link]] (ไม่ใช่ path) · frontmatter ตาม VAULT-CONVENTIONS

5.5.5 — ลบ inbox note (Mode B ข้อ 4 — กัน stale duplicate):

ls "kb/01-projects/<service>/$ISSUE/" && rm "kb/00-inbox/"*"$ISSUE"*.md

⚠️ kb/ = symlink → repo kol-brain แยก: commit/push ที่ kol-brain โดยตรง (ไม่ใช่ kol-architecture)

Step 6: Update Focus & Activity Log

Update docs/current.md:

export TZ='Asia/Bangkok'

cat > docs/current.md << EOF
STATE: completed
TASK: [task from original focus]
SINCE: $(date '+%Y-%m-%d %H:%M')
ISSUE: #[issue-number]
EOF

Append to docs/logs/activity.log:

export TZ='Asia/Bangkok'
echo "$(date '+%Y-%m-%d %H:%M') | completed | [task]" >> docs/logs/activity.log

Step 7: Check PR Status & Commit Docs

For the full PR status checking and commit workflow, see pr-commit-workflow.md.

Step 8: Check Documentation Updates

ตรวจสอบว่าต้อง update เอกสารหรือไม่:

File	Check When
README.md	เพิ่ม feature ใหม่, เปลี่ยน API, เปลี่ยน structure
SETUP.md	เปลี่ยนขั้นตอนการติดตั้ง
SKILL.md	เปลี่ยน skill definition
CLAUDE.md	เปลี่ยน rules หรือ conventions
assets/commands/*.md	เปลี่ยน command behavior

ถ้าพบว่าต้อง update:

Documentation Check

การเปลี่ยนแปลงนี้อาจต้อง update เอกสาร:

| File | Reason |
|------|--------|
| `README.md` | [reason] |

ต้องการให้ update เอกสารเลยไหม?

Step 9: Confirm & Remind

## Session Complete

### Summary
- Issue: #[issue-number] - Comment added
- Retrospective: kb/05-ai-reviewed/retrospective/[path]

### Next Steps
1. ใช้ `/pr` เพื่อรัน tests, build, review และสร้าง PR
2. รอ reviewer approve PR
3. แก้ไขตาม feedback (ถ้ามี)
4. ใช้ `/focus` เพื่อเริ่มงานใหม่

Template (Retrospective)

Use full template from references/td-template.md.

Workflow Integration

/focus  -->  Work  -->  /commit  -->  /pr  -->  /td
  |                        |          |         |
Create                  Atomic     Tests/     Session
Issue                   Commits    Build/     Summary
                                   Review/
                                   PR

Related Commands

Command	Purpose
/focus	ตั้ง focus และสร้าง issue
/commit	Atomic commits
/pr	รัน tests, build, review และสร้าง PR
/td	สร้าง retrospective (คุณอยู่ที่นี่)
/recap	ดู context
/mem	บันทึก knowledge