spk-prime

name	spk-prime
description	Prime repo เพื่อ development - scan source folders และสร้าง/อัพเดต AGENTS.md context files โดยให้ CLAUDE.md เป็น @AGENTS.md pointer
argument-hint	[scope: repo|frontend/|apps/api/|packages/*]

spk-prime

Scan source-code folders และสร้างหรืออัพเดต AGENTS.md เป็น canonical local context file เพื่อให้ downstream development work มี project knowledge ที่ถูกต้อง โดย CLAUDE.md ใน folder เดียวกันต้องเป็น pointer บรรทัดเดียว @AGENTS.md

รวบรวม Context

• ถ้าอยู่ใน git worktree ให้รัน git status --short และ git log -3 --oneline; ถ้าไม่ใช่ git repo ให้ข้าม git context และทำงานต่อ
• ระบุ source subtrees ที่สำคัญ (package.json, pyproject.toml, go.mod, Cargo.toml, tsconfig, requirements.txt)

Workflow

1. Scan Source Roots

• เดินตาม project tree และระบุ source directories ที่สำคัญ
• ข้าม node_modules, .git, dist, build และ generated directories อื่น ๆ
• เคารพ .gitignore patterns

2. วิเคราะห์แต่ละ Subtree

• ระบุ: language, framework, test setup, build tool, entry points
• บันทึก dependencies, scripts และ configuration
• ตรวจจับ monorepo structure (workspaces, packages, apps)
• อ้างทุก claim จาก source code ที่อ่านจริงในรอบนี้ — AGENTS.md/CLAUDE.md/README ที่มีอยู่เดิมถือเป็น hint ที่ยังไม่ verify ไม่ใช่ source of truth (อาจ stale หรือผิด) ห้าม copy ข้อเท็จจริงจากไฟล์ context เดิมมาตรง ๆ ให้ re-derive จาก source (โค้ด, manifest.json/package.json, โครงไดเรกทอรี) แล้ว confirm ก่อนเขียน ถ้า claim เดิมขัดกับ source จริง → ยึด source แล้วแก้ให้ถูก ถ้า verify ไม่ได้ → ตัดทิ้ง อย่า carry forward

3. สร้างหรืออัพเดต Context Files

• เขียนหรืออัพเดต AGENTS.md ที่ root และใน source subfolders ที่เกี่ยวข้องเป็น source of truth
• ให้ CLAUDE.md ใน folder เดียวกันมีเฉพาะ pointer บรรทัดเดียว @AGENTS.md
• ถ้ามี CLAUDE.md เดิมที่มีเนื้อหาสำคัญ ให้ migrate เนื้อหาเฉพาะที่ยังไม่มีไปไว้ใน AGENTS.md ก่อน แล้วค่อยเปลี่ยน CLAUDE.md เป็น pointer
• แต่ละ AGENTS.md ต้องมี section ## Scoped Commands (คำสั่ง test/build/lint เฉพาะของ subtree นั้น ไม่ใช่ค่า default ของทั้ง repo) เพื่อให้รันเฉพาะที่เกี่ยวข้อง ไม่ติด timeout จากการรันทั้งชุด
• แต่ละ AGENTS.md ต้องมี section ## Code Navigation ที่ชี้ให้ใช้ tools mcp__spk-codebase-search__* เมื่อมี (search_code, find_symbol, file_outline) และให้ fallback ไป Grep/Glob เมื่อไม่มี — อย่า hard-depend
• สร้างหรืออัพเดต .claudeignore ที่ root โดยลิสต์ path ที่ generated/vendor/build ปริมาณมาก (node_modules/, dist/, build/, coverage/ ฯลฯ) เพื่อให้การค้นโค้ดแม่นและไม่เจอ noise
• เก็บ AGENTS.md ให้กระชับและตรงตัวเป็นจริง
• อย่า hardcode ข้อเท็จจริงที่เปลี่ยนบ่อยลงใน prose — ห้ามเขียนเลข version, วันที่ release, หรือจำนวน (skills, agents, commands, ไฟล์, tests) ที่มีอยู่แล้วในไฟล์ source-of-truth เพราะมันจะ stale ทันทีที่มีอะไรเปลี่ยน และขัดกับไฟล์ที่เป็นเจ้าของข้อมูลนั้น ให้ชี้ไปที่ source แทน เช่นเขียนว่า "ดู manifest.json สำหรับ version และ roster ของ command/agent ที่เป็นทางการ" ไม่ใช่ "v3.2.0, 17 skills, 21 agents" — ระบุเฉพาะข้อเท็จจริงที่คงทน (สถาปัตยกรรม, ownership, conventions, คำสั่ง) ส่วนอะไรที่เปลี่ยนทุก release ให้ชี้ไป manifest/package
• อนุรักษ์เนื้อหาที่คนเขียนใน AGENTS.md อย่าเขียนทับ sections ที่มีอยู่
• ปิดท้ายแต่ละ AGENTS.md ด้วยบรรทัดเตือน: ให้ prime ใหม่ตาม scope หลังมีการเปลี่ยนโครงสร้าง (เพิ่ม package, ย้าย dir, เปลี่ยนคำสั่ง test/build) ไฟล์จะได้ไม่ล้าสมัยเงียบ ๆ

4. ตรวจสอบ

• ยืนยันว่าไม่มี source code ถูกแก้ไข
• ยืนยันว่าไม่มี secrets ถูกเขียน
• ยืนยันว่า CLAUDE.md ทุกไฟล์ที่อยู่คู่กับ AGENTS.md มีแค่ @AGENTS.md
• ยืนยันว่าเคารพ .gitignore

Output Format

## Prime Report
- Scope: <repo หรือ specific paths>
- Source trees ที่พบ: <list>
- Context files ที่สร้าง: <list ของ AGENTS.md/CLAUDE.md pointer>
- Context files ที่อัพเดต: <list ของ AGENTS.md/CLAUDE.md pointer>
- Corrections: <claim เดิมที่ source ขัด เช่น `corrected <หัวข้อ>: ไฟล์เขียน "<A>" แต่ source เป็น "<B>"`, `dropped <claim>: verify กับ source ไม่ได้` — ถ้าไม่มีให้เขียน "none — claim เดิมตรงกับ source">
- Directories ที่ข้าม: <list>
- Source code ที่เปลี่ยน: <none>
- Secrets ที่พบ: 

ข้อควรระวัง

• อย่าแก้ product source code
• อย่าเขียน secrets เข้า context files
• เคารพ .gitignore
• อย่าเขียนเนื้อหาซ้ำทั้งใน CLAUDE.md และ AGENTS.md; CLAUDE.md ต้องเป็น @AGENTS.md
• อนุรักษ์เนื้อหาที่คนเขียนใน AGENTS.md ที่มีอยู่
• เก็บ AGENTS.md ให้กระชับ ชอบ structure และ commands มากกว่า prose