spk-jumpstart

name	spk-jumpstart
description	เริ่มต้นใช้งานครั้งแรกแบบ jumpstart - ตรวจ repo, สร้าง AGENTS.md ถ้ายังไม่มี, ถาม 1 คำถาม, พาไปถึง first win (plan ที่รีวิวแล้ว) และยืนยัน 1 ครั้งก่อนเขียนโค้ด
argument-hint	[เป้าหมาย (ไม่บังคับ) เช่น เพิ่มหน้า login]

spk-jumpstart

เส้นทางที่เร็วที่สุดจากติดตั้งเสร็จไปถึง first win บน project จริงของคุณ: ถาม 1 คำถาม ยืนยัน 1 ครั้ง และไม่แตะ source code ก่อนได้รับอนุมัติ

ใช้ตอน: เพิ่งเริ่มใช้ครั้งแรก, "เริ่มยังไง", "start here", หรืออยากได้ guided first run

Workflow

1. Orient ตรวจ repo status, instructions, manifests และ SPK scaffold แบบ read-only ถ้า scoped guidance หายให้บอก effect PROJECT_WRITE แล้วทำ repository priming
2. ถามเป้าหมายหนึ่งข้อ ถ้า user ให้ goal แล้วให้ใช้เลย ไม่งั้นถามว่าอยาก build, fix หรือ redesign อะไร ห้ามเริ่ม interview ยาว
3. เลือกเส้นทางเดียว
   • behavior/architecture ใหม่ → planning
   • bug/regression → root-cause debugging โดยไม่ patch
   • UI direction → design-shotgun โดยไม่แก้ production
   • งานอื่น → canonical SPK router
4. สร้าง first win คืน reviewed plan, proven diagnosis + smallest fix หรือ comparison board + recommendation และมี verifier pass
5. ถามครั้งเดียวก่อน implement สรุป scope, paths, tests และ effect แล้วเริ่ม source write เฉพาะคำตอบ yes ที่ชัด คำตอบกำกวมไม่นับ
6. Implement เมื่ออนุมัติ ใช้ implementation/TDD workflow โดยยึด first-win artifact ห้าม stage, commit, push, เปิด PR หรือ deploy เว้นแต่ขอและอนุมัติแยก

Budget: orientation หนึ่ง pass, user question หนึ่งข้อ, primary workflow หนึ่งอัน, verifier หนึ่งอัน และ implementation confirmation หนึ่งครั้ง

Evidence Receipt

คืน spk.evidence/v1 ที่มี routed workflow, effect, orientation artifacts, first-win artifact, verification, assumptions, approval state, risks และ next action

Guardrails

• ห้ามเขียน production source ก่อน explicit implementation approval
• ถ้า host ไม่มีผู้ช่วยย่อยให้ทำ sequential ต่อ ไม่ถือเป็น blocker
• External writes และ uninstall ต้องผ่าน manual approval protocol ของตัวเอง
• Repo ว่างเปล่า: สร้าง AGENTS.md แบบ minimal แล้วชวนวาง plan ของ feature แรก
• ถ้า user ยกเลิกกลางทาง: มีแค่ AGENTS.md / CLAUDE.md / ai_context/ ที่ถูกสร้าง ซึ่งมีประโยชน์ในตัวเองอยู่แล้ว บอก user 1 บรรทัด