CLAUDE.md Workshop

คู่มือพนักงานใหม่สำหรับ AI

nnn → gogogo → rrr → ccc

SIIT Workshop - December 2025

Part 1: ทำไมต้อง CLAUDE.md?

ปัญหา

"เพิ่ม login feature หน่อย"

⬇️

AI ที่ไม่มี context:

framework? auth method? file location?

⬇️

code ทั่วไปที่ไม่เข้ากับ project

ทางออก

CLAUDE.md

คู่มือสำหรับ AI ของ project

เหมือน คู่มือพนักงานใหม่
แต่สำหรับ AI assistant ของคุณ

ไม่มี vs มี

ไม่มี CLAUDE.md

"ผมจะสร้าง auth ด้วย JWT..."

ทั่วไป, structure ผิด

มี CLAUDE.md

"จาก Next.js + Supabase..."

ตรงกับ project

ใส่อะไรใน CLAUDE.md?

Project Context — Stack, structure, conventions

Safety Rules — ห้ามทำอะไร, git workflow

Short Codes — รหัสลับสำหรับ workflow

Part 2: Short Codes

Short Codes

รหัสลับสำหรับ AI

พิมพ์สั้น = AI รู้เลยว่าต้องทำอะไร

ทำไมเรียก "รหัสลับ"?

แนวคิดสนุกๆ ที่ทำให้ AI เป็นเพื่อนทำงาน

"เฮ้ เพื่อน! nnn ให้หน่อย"

เหมือนรู้กันอยู่ 2-3 คน ไม่ต้องอธิบายยาว

ใส่อีโมชั่น ใส่ความรู้สึก พิมพ์สั้นๆ แต่เข้าใจกัน

ปัญหา

พิมพ์ยาว = เสียเวลา

"วิเคราะห์ task สร้าง GitHub issue แล้ววางแผน implementation"

พิมพ์แค่: nnn

Core 4 Short Codes

nnn — วางแผน (START HERE)

gogogo — ลงมือทำ

rrr — สรุป session

ccc — เก็บ context

nnn - Create Plan

START HERE

"วางแผนก่อนทำ"

1. วิเคราะห์ task/issue

2. Research codebase

3. สร้าง plan issue พร้อม steps

ง่ายที่สุด - มี task อยู่แล้ว!

gogogo - Execute

"ลงมือทำ!"

1. หา plan issue ล่าสุด

2. Execute step-by-step

3. Commit & push

rrr - Retrospective

"สรุปบทเรียน"

1. What happened?

2. What worked / failed?

3. Lessons learned

4. Update CLAUDE.md

ccc - Context Capture

"เก็บ context ไว้ก่อน"

1. รวบรวม state ปัจจุบัน

2. สร้าง GitHub issue

3. Compact conversation

ใช้ตอนพักงาน หรือส่งต่อให้คนอื่น

The Flow

nnn → gogogo → rrr → ccc

(วางแผน) → (ลงมือทำ) → (สรุป) → (เก็บ context)

Start with nnn - ง่ายที่สุด!

Issue = External Memory

"ความจำสำรองภายนอก"

แชท — หายไปเมื่อปิด session

GitHub Issue — อยู่ถาวร + ดูง่าย

เปิด session ใหม่ → บอก AI อ่าน issue → ทำต่อได้เลย

Part 3: Safety Rules

กฎความปลอดภัย

1. ห้ามใช้ --force flags เด็ดขาด

2. ห้าม merge PRs โดยไม่ได้รับอนุญาต

3. ห้าม rm -rf หรือ destructive commands

4. ถามก่อนทำ destructive actions

Git Safety

สร้าง feature branch เสมอ

สร้าง PR เสมอ (ห้าม push ตรง main)

รอ human approve ก่อน merge

ห้าม force push, ห้าม hard reset

Part 4: สร้างของคุณเอง

สร้าง Short Code ของคุณเอง

### ddd - Deploy
1. Run tests
2. Build production
3. Create git tag
4. Deploy to server

ใส่ใน CLAUDE.md = AI รู้วิธีทำ

Template เริ่มต้น

# Project Name

## Project Context — Stack, conventions

## Safety Rules — ห้ามทำอะไร

## Short Codes — nnn, gogogo, rrr, ccc

เคล็ดลับ

1. เริ่มเล็กๆ — เพิ่มกฎเมื่อพบความต้องการ

2. เฉพาะเจาะจง — "ใช้ Tailwind" ไม่ใช่ "ใช้ CSS framework"

3. อัพเดทบ่อยๆ — CLAUDE.md โตไปกับ project

4. ทดสอบ — เริ่ม session ใหม่ AI เข้าใจไหม?

สรุป

CLAUDE.md = คู่มือพนักงานใหม่สำหรับ AI

3 สิ่งสำคัญ: Context, Safety, Short Codes

nnn → gogogo → rrr → ccc

Start with nnn - ง่ายที่สุด!

ถาม-ตอบ

มีคำถามไหม?

Template: gist.github.com/nazt/...