# Add Phase

> เพิ่ม development phase ใหม่เข้าโปรเจค พร้อมสร้าง phase plan, backlog file และ archive section ใช้ skill นี้เมื่อต้องการแบ่งโปรเจคเป็นช่วงๆ เช่น "เพิ่ม phase ใหม่", "เริ่ม phase ถัดไป"

- Skill: `natthasath/add-phase` (Agent Skill)
- Install (CLI): `npx skillmds@latest add natthasath/add-phase`
- Raw SKILL.md: https://api.skillmd.com/api/skills/natthasath/add-phase/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: natthasath (https://skillmd.com/u/natthasath)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/natthasath/add-phase

---


!`cat context/plans/PLAN.md 2>/dev/null`

เพิ่ม phase ใหม่เข้าโปรเจค: $ARGUMENTS

**Format:** `/add-phase <ชื่อ phase> [target date]`
**ตัวอย่าง:** `/add-phase "API Integration" 2026-09-01`

---

## ขั้นที่ 1 — วิเคราะห์ argument

แยก $ARGUMENTS ออกเป็น:
- **ชื่อ phase** — ทุกอย่างก่อน date pattern `YYYY-MM-DD` (ถ้ามี)
- **target date** — ถ้ามี date pattern ใน argument ให้ใช้, ถ้าไม่มีให้ใส่ `TBD`
- **slug** — lowercase, replace space ด้วย `-` (เช่น "API Integration" → `api-integration`)

## ขั้นที่ 2 — หา phase number ถัดไป

อ่าน Status Overview table จาก PLAN.md ด้านบน หา phase number สูงสุดแล้วบวก 1
- ถ้าไม่มี phase เลย ให้เริ่มที่ phase `1`

## ขั้นที่ 3 — Draft และขอ confirm

แสดง preview ก่อน:

```
📋 Phase Draft

Phase:   <N> — <ชื่อ>
Target:  <date หรือ TBD>
Files ที่จะสร้าง:
  · context/plans/PLAN.md                          (เพิ่ม row)
  · context/plans/phase_<N>_<slug>.md              (สร้างใหม่)
  · context/tasks/backlog/phase_<N>_backlog.md     (สร้างใหม่)
  · context/tasks/completed/archive.md             (เพิ่ม section)
```

ถามว่า "ต้องการแก้ไขอะไรไหม หรือ OK ให้สร้างเลย?"
รอ confirm ก่อนทำขั้นต่อไป

## ขั้นที่ 4 — อัปเดต PLAN.md

เพิ่ม row ต่อท้าย Status Overview table:
```
| <N> | <ชื่อ> | 🔲 Not Started | <date> |
```

เพิ่ม link ต่อท้าย Phase Files section:
```
- [Phase <N>: <ชื่อ>](phase_<N>_<slug>.md)
```

## ขั้นที่ 5 — สร้าง phase plan file

สร้าง `context/plans/phase_<N>_<slug>.md`:

```markdown
# Phase <N>: <ชื่อ>

**Status:** 🔲 Not Started
**Target:** <date หรือ TBD>
**Depends on:** Phase <N-1> complete
**Goal:** <สรุปสั้นๆ จากชื่อ phase — แก้ไขได้ภายหลัง>

## Objectives

_(เพิ่ม objectives เมื่อวางแผน)_

## Deliverables

_(เพิ่ม deliverables เมื่อวางแผน)_

## Acceptance Criteria

- [ ] _(เพิ่ม criteria เมื่อวางแผน)_
```

## ขั้นที่ 6 — สร้าง backlog file

สร้าง `context/tasks/backlog/phase_<N>_backlog.md`:

```markdown
# Phase <N> Backlog — <ชื่อ>

_(เพิ่ม tasks ด้วย /add-task)_
```

## ขั้นที่ 7 — อัปเดต current-phase config (เฉพาะกรณีแรก)

อ่าน `.claude/config/current-phase.md` — ถ้า `phase:` ยังเป็น "(ยังไม่มี...)" หรือว่างเปล่า
ให้เขียน `phase: <N>` ลงไป เพื่อให้ skills อื่นรู้ว่า phase ปัจจุบันคืออะไร

**ถ้ามี phase อื่น In Progress อยู่แล้ว — ไม่ต้องแก้ไข current-phase.md**

## ขั้นที่ 8 — เพิ่ม section ใน archive

เปิด `context/tasks/completed/archive.md` แล้ว append ต่อท้าย:

```markdown
## Phase <N> Completed Tasks

_(จะมี entries เมื่อ tasks เสร็จ)_

---
```

## ขั้นที่ 9 — สรุปผล

```
✅ Phase <N> — <ชื่อ> สร้างเสร็จแล้ว

ไฟล์ที่สร้าง/แก้ไข:
  ✅ context/plans/PLAN.md
  ✅ context/plans/phase_<N>_<slug>.md
  ✅ context/tasks/backlog/phase_<N>_backlog.md
  ✅ context/tasks/completed/archive.md
  ✅ .claude/config/current-phase.md  (ถ้าเป็น phase แรก)
```

```
─────────────────────────────────────────────────────
ถัดไป → /add-task <description>   (เพิ่ม tasks เข้า phase ใหม่)
         /list-phase               (ดูภาพรวม phases ทั้งหมด)
─────────────────────────────────────────────────────
```