Skip to content

CLAUDE.md

Latest commit

 

History

History
75 lines (56 loc) · 10.9 KB

CLAUDE.md

File metadata and controls

75 lines (56 loc) · 10.9 KB
Raw

CLAUDE.md (ไทย)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

@AGENTS.md

กฎทั้งหมดของโปรเจกต์อยู่ใน AGENTS.md — แหล่งข้อมูลจริงเพียงแห่งเดียวสำหรับผู้ช่วย AI ทุกตัว (สถาปัตยกรรม แบบแผน การทดสอบ ด่านตรวจคุณภาพ เวิร์กโฟลว์ git กฎบังคับ 23 ข้อ และบทเรียนเกี่ยวกับ PII) โปรดอ่านทั้งหมด และอย่าเพิ่มกฎของโปรเจกต์ซ้ำที่นี่ ทุกสิ่งด้านล่างนี้ใช้ กับ Claude Code เท่านั้น — เป็นรายละเอียดเชิงปฏิบัติการเพิ่มเติมของกฎที่กำหนดไว้แล้วใน AGENTS.md

การแยก Worktree — รายละเอียดเฉพาะของ Claude Code

โปรโตคอล worktree แบบบังคับฉบับสมบูรณ์ (การยืนยัน base branch, เส้นทางมาตรฐาน .claude/worktrees/, cp -al node_modules, กฎการ teardown) อยู่ที่ docs/ops/WORKTREE_ISOLATION.md (สรุปไว้ใน AGENTS.md → Git Workflow → "Worktree isolation") ประเด็นเฉพาะสำหรับ Claude Code:

  • ยืนยัน base branch กับผู้ใช้งานผ่าน AskUserQuestion (Hard Rule #19) เว้นแต่พวกเขาจะ บอกคุณไว้แล้ว
  • แนะนำให้ใช้เครื่องมือ EnterWorktree ที่มีอยู่แล้วในระบบ — เครื่องมือนี้สร้าง worktree ไว้ใต้ .claude/worktrees/ (เส้นทางมาตรฐาน) อยู่แล้ว ให้สร้าง worktree ด้วยคำสั่ง git worktree add ตามที่ระบุไว้ในเอกสาร จากนั้นเรียก EnterWorktree พร้อมกับ path ของมัน

ความปลอดภัยข้ามเซสชัน — รายละเอียดเฉพาะสำหรับ Claude Code

กฎบังคับ #19/#21/#22 (ใน AGENTS.md) ควบคุมเซสชันที่ทำงานขนานกัน ข้อควรจำเชิงปฏิบัติการสำหรับ ระบบนี้:

  • ทำซ้ำข้อห้ามใช้ git stash แบบคำต่อคำในพรอมต์ของ subagent ทุกตัวที่ทำงานกับ git (เครื่องมือ Agent / สคริปต์ Workflow) — subagent จะไม่ได้รับไฟล์นี้โดยอัตโนมัติ และเหตุการณ์ stash ที่เกิดซ้ำตามบันทึกนั้นเกิดขึ้นผ่าน subagent
  • ก่อน merge หรือ push ไปยัง PR ใดก็ตามที่คุณไม่ได้สร้าง ในเซสชันนี้ ให้รัน git worktree list และตรวจสอบ gh pr view <N> --json state,headRefOid อีกครั้ง (กฎบังคับ #22b)
  • จบทุกเซสชันโดยให้ checkout หลักอยู่บน branch เดียวกับตอนที่เริ่มต้นเซสชัน

Superpowers / อาร์ติแฟกต์การวางแผน — การแทนที่พาธ

แบบแผน _tasks/ กำหนดไว้ใน AGENTS.md → "Planning & Research Artifacts" ทักษะ superpowers มาพร้อมค่าเริ่มต้นที่ชี้ไปยัง docs/… — ค่าเริ่มต้นเหล่านั้นถูก แทนที่ ที่นี่ เมื่อทักษะ superpowers แจ้งพาธอย่าง "saved to docs/superpowers/plans/…" ให้เปลี่ยนเป็นพาธที่เทียบเท่าภายใต้ _tasks/… ก่อนเขียนไฟล์:

อาร์ติแฟกต์ (ทักษะ) ค่าเริ่มต้น (ห้ามใช้) ให้บันทึกที่นี่แทน
แผน (writing-plans) docs/superpowers/plans/ _tasks/superpowers/plans/YYYY-MM-DD-<feature>.md
ข้อกำหนด / การออกแบบ (brainstorming) docs/superpowers/specs/ _tasks/superpowers/specs/YYYY-MM-DD-<topic>-design.md
งานวิจัย (deep-research, เฉพาะกิจ) docs/research/ _tasks/research/…
การส่งต่องาน (/handoff) — _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/

commit อาร์ติแฟกต์เหล่านั้นภายใน repo _tasks/ (git -C _tasks …) เท่านั้น ห้าม commit ใน repo หลัก

ไฟล์ร่าง / ไฟล์ชั่วคราว — ใช้ _artifacts/ ไม่ใช่ /tmp

โปรเจกต์นี้แทนที่ scratchpad เริ่มต้นประจำเซสชันของระบบ (/tmp/claude-*/…) ให้เขียน ไฟล์ชั่วคราว/ไฟล์ระหว่างทำงาน — ไฟล์ export, zip ที่สร้างขึ้น, เอาต์พุตขั้นกลางแบบใช้ครั้งเดียว หรือสิ่งใดก็ตามที่ปกติคุณ จะใส่ใน /tmp — ไปยัง /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/ แทน

  • _artifacts/ เป็นพาธ _* ที่ root: ถูก gitignore ไว้แล้ว (AGENTS.md → "Root _* paths") และอยู่ บนดิสก์เท่านั้น โดยจะไม่ถูกติดตาม
  • เหตุผล: การเก็บเอาต์พุตชั่วคราวไว้ภายในโปรเจกต์ (แทน /tmp) ช่วยให้ผู้ดำเนินการ ค้นหาและลบสิ่งชั่วคราวทั้งหมดได้ง่ายในที่เดียว แทนที่จะต้องตามหาในไดเรกทอรี /tmp เฉพาะแต่ละเซสชันที่อาจหายไปหรือสะสมไฟล์ที่ไม่ได้ติดตาม
  • อย่า สับสนกับ _tasks/ (กฎบังคับ #23 ซึ่งเป็น repo git ส่วนตัวแยกต่างหากสำหรับ แผน/ข้อกำหนด/งานวิจัย/การส่งต่องานที่ต้องเก็บถาวร) — _artifacts/ ใช้สำหรับไฟล์ระหว่างทำงานที่ทิ้งได้เท่านั้น ไม่มีสิ่งใด ที่นี่ต้องคงอยู่หรือได้รับการควบคุมเวอร์ชัน

ตรวจสอบว่า base เป็นสีเขียวก่อนเปิด PR

ก่อนสร้าง branch หรือเปิด PR ให้รันการตรวจสอบ base-green (AGENTS.md → Git Workflow → "Base-green check"; ทักษะของโปรเจกต์อ้างอิงถึงขั้นตอนนี้ใน .agents/skills/_shared/base-green.md) PR ที่ เปิดขณะที่ tip ของ base เป็นสีแดงต้องมี ⚠️ base-red inherited: #<issue> ในเนื้อหา หากต้องการ สะสางสถานะสีแดงที่สะสมอยู่ (tip ของ base + PR ที่เป็นสีแดง) ให้ใช้ทักษะ /sweep-reds