From 83a0b8834cfdd963403cb98a585e204730bfef44 Mon Sep 17 00:00:00 2001 From: Your Name Date: Thu, 24 Sep 2026 18:35:59 +0700 Subject: [PATCH] docs: record user profile as 20yr full-stack dev and interaction guidelines in agent rules --- .agents/skills/orchestrator/SKILL.md | 1 + AGENTS.md | 6 ++++++ 2 files changed, 7 insertions(+) diff --git a/.agents/skills/orchestrator/SKILL.md b/.agents/skills/orchestrator/SKILL.md index 26452da..d9b6a78 100644 --- a/.agents/skills/orchestrator/SKILL.md +++ b/.agents/skills/orchestrator/SKILL.md @@ -20,6 +20,7 @@ description: Main Agent / Multi-Agent Orchestrator for planning, delegation, coo - **Read before assigning:** ก่อนสั่งงานโดยอ้างชื่อ field, type, API, schema, route, token, หรือ component ต้องอ่าน source จริงก่อน - **Verify after delivery:** งานจาก agent ต้องถูกตรวจตาม risk ไม่ใช่รับผลแล้วส่งต่อทันที - **Escalate early:** ถ้าปัญหาข้ามขอบเขต agent หรือกระทบ contract/schema/infra ให้หยุดและแจ้งผู้รับผิดชอบ +- **Senior Developer Partnership:** ผู้ใช้คือ Senior Full-Stack Developer ประสบการณ์กว่า 20 ปี เข้าใจ Code, Architecture และระบบทุกส่วนอย่างลึกซึ้ง ห้ามทำตัวเสมือนคุยกับ non-coder / vibe coder ที่ไม่รู้เรื่อง code หากติดขัด สงสัย หรือเกิดเคสผิดปกติ ให้ถามและปรึกษาผู้ใช้โดยตรงทันที ห้ามเดาหรือทำ workaround ที่ซับซ้อนไร้ทิศทาง - **No silent workaround:** ห้ามทำทางลัดเพื่อให้ดูเหมือนงานเสร็จ ทั้งที่ขัดกับ process, tool, contract, หรือ architecture ที่ทีมวางไว้ --- diff --git a/AGENTS.md b/AGENTS.md index 962c2e0..f10af44 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -43,3 +43,9 @@ Every final handoff should summarize: - **FORBIDDEN:** You are strictly prohibited from using `view_file`, `grep_search`, `run_command`, or reading any backend source code (e.g., `schema.prisma`, `types`) to find answers or discover capabilities. - **ESCALATE LIMITATIONS:** If the MCP server fails to provide the necessary tools, metadata, or schema descriptions for you to complete a task, you MUST immediately report this architectural flaw to the user. Do not use local file system tools as a silent workaround. - **NO SILENT WORKAROUNDS (UX/DX AUDIT):** Do NOT fix errors yourself under any circumstances. If you encounter an error on your first natural attempt to use a tool, you MUST report back immediately with the exact error. Your goal is to find bad Developer Experience (UX/DX) and improve the tool, NOT to just succeed at the task at all costs. + +## User Persona & Interaction Guidelines +- **User Profile:** The user is a **Senior Full-Stack Developer with 20+ years of experience**. +- **No "Vibe Coder" Assumptions:** Do NOT treat the user as a beginner or non-technical person who doesn't understand code. Communicate engineer-to-engineer with technical depth, exact facts, clear architecture, and concise reasoning. +- **Consult & Ask Directly When In Doubt:** When hitting an ambiguity, unexpected roadblock, architectural decision, or missing context, **ASK THE USER DIRECTLY**. Do not guess, do not wander aimlessly into convoluted workarounds, and do not make assumptions. The user has comprehensive full-stack expertise and can clarify or resolve direction immediately. +