# Plane Agent Guide

version: 0.1.0
last_updated: 2026-07-01
status: Phase 1 operational guide

เอกสารนี้เป็น operational sync guide สำหรับงาน Plane ที่ทำซ้ำบ่อย ไม่ใช่ one-time installation guide และไม่ใช่ source of truth ด้าน requirement ของระบบ Companion

## Scope

ใช้กับ Dev Agent ที่ต้องอ่าน/สร้าง/อัปเดต/ปิดงานใน Plane ระหว่าง Phase 1: Plane-First Agent-Guided Intake

Plane MCP เป็น default path เสมอ ถ้า MCP ไม่รองรับ action ที่ต้องทำ ให้หยุดและระบุเหตุผลก่อนใช้ Plane API ตรง โดยต้องมี human decision หรือบันทึกเหตุผลในงานนั้น

## Connection

ค่า local สำหรับ Codex เครื่องนี้อยู่ใน `/Users/rk/Projects/plane-companion/.env` และถูกเรียกผ่าน wrapper:

```bash
/Users/rk/Projects/plane-companion/bin/plane-mcp-codex
```

Codex MCP config ใช้ server ชื่อ `plane` ใน `~/.codex/config.toml`

## Commands

### `plane:check`

ใช้ก่อนสร้างงานใหม่หรือก่อนอัปเดตงานที่มีความเสี่ยง duplicate

- list projects
- list current project issues
- ค้นหาชื่อ/เนื้อหาคล้ายกันก่อน create
- ตรวจ status/priority ที่จะใช้
- รายงานว่าจะ update งานเดิมหรือ create งานใหม่

### `plane:intake`

ใช้รับงานใหม่เข้า Plane

- ต้องมี project
- ต้องมีชื่อที่สื่อ action/result
- ต้องระบุ origin อย่างน้อยหนึ่งแบบ: active project task, owner-test feedback, UAT feedback, backfilled work, support/intake note
- priority ใช้เป็น priority จริง ไม่ใช้ Backlog แทน priority
- estimate อาจเว้นว่างได้ แต่ต้องบอกว่า estimate-later และยังไม่นับเป็น capacity credit

### `plane:update`

ใช้เปลี่ยน status, priority, description, comment หรือ evidence

- update status ตาม baseline
- เพิ่ม comment เมื่อมี context สำคัญ เช่น blocker, test evidence, manual verification
- หลีกเลี่ยงการแก้ประวัติย้อนหลังแบบทำให้ evidence หาย

### `plane:backfill`

ใช้สร้างงานย้อนหลังสำหรับงานที่ทำไปแล้วก่อนเริ่มใช้ Plane

- title หรือ description ต้องมี `Backfilled Work`
- ต้องมี Actual Completed Date ถ้ารู้วันที่
- ต้องระบุ evidence เท่าที่มี
- งาน backfilled อาจปิดได้ทันทีถ้ามีหลักฐานเพียงพอ

### `plane:close`

ใช้ปิดงาน low-risk หรือ confirmed done

- ต้องมี closure evidence หรือ manual verification note
- ถ้าไม่มี estimate ให้ปิดได้แต่ต้องไม่ claim capacity credit
- ถ้าเป็นงาน risk สูงหรือมีผลกับ production ให้ขอ human verification ก่อนปิด

### `plane:review`

ใช้ตรวจงานใน Plane

- list งานตาม project/status
- ตรวจว่า Done/Closed มี evidence
- ตรวจ duplicate risk
- ตรวจงาน estimate-later ที่ยังไม่ควรถูกนับ capacity credit
- สรุป pain point เพื่อส่งต่อ Phase 2/3

## Status Baseline

Plane CE ใช้ status แยกตาม project รอบ Phase 1 ให้แต่ละ project ใช้ชื่อ baseline เดียวกัน:

- Not started
- In progress
- Waiting/Blocked
- Review/Test/UAT
- Ready for deployment
- Done/Closed
- Canceled

`Backlog` เป็น system bucket ของ Plane ที่อาจคงอยู่ใน project แต่ไม่ใช่ priority

## Priority Baseline

Plane priority mapping:

- `urgent` = P0 Critical
- `high` = P1 High
- `medium` = P2 Medium
- `low` = P3 Low

ห้ามใช้ Backlog แทน priority

## Guardrails

- ห้าม delete/archive ใน normal agent workflow
- ห้ามใช้ admin token สำหรับ workflow ปกติถ้ามี least-privilege account/token พร้อม
- ห้ามปิดงานโดยไม่มี evidence หรือ manual verification note
- ห้ามนับ capacity credit จากงานที่ไม่มี estimate
- งาน support/requester-facing ทั่วไปยังถือว่าเป็น boundary ของ Zammad Phase 2 เว้นแต่ถูก classify เป็น dev work แล้ว

## Phase 1 Evidence

Execution 2026-07-01:

- Plane public URL: `https://plane.dev.mfu.ac.th`
- Workspace: `mfu-dev`
- MCP package: `@makeplane/plane-mcp-server` 0.1.5
- MCP smoke: `tools/list` returned 47 tools; `get_projects` listed MFU Dev, MFU Dev Platform, MFU CouncilTrack, Plane Companion
- MCP token owner: `plane-agent@mfu.ac.th`, workspace/project member role `15`
- Trial work items created through MCP: 6

## Changelog

| Version | Date | Notes |
| --- | --- | --- |
| 0.1.0 | 2026-07-01 | Initial guide for Phase 1 Plane-first MCP workflow, status/priority baseline, backfill/closure rules |