# Describe Progress File

> Structure and field ownership for progress.yaml. Load when reading or updating phase progress state.

- Skill: `majiayu000/describe-progress-file` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/describe-progress-file`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/describe-progress-file/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/describe-progress-file

---


## progress.yaml

Machine-readable state of the Phase. Structure:

```yaml
phase:
  id: NNNN
  slug: short-slug
  title: Title
  status: planned|building|review|complete

steps:
  - id: S001
    title: Short title
    implemented: false
    reviewed: false
    notes: ""
    touched: []
```

**Status transitions**:
- `planned` → `building` (when Builder starts)
- `building` → `review` (when all steps implemented)
- `review` → `building` (if Overseer requests fixes)
- `review` → `complete` (when Overseer approves)

**Field ownership**:
- `implemented`: Set by Builder when step is done
- `reviewed`: Set only by Overseer
- `notes`: Updated by whoever completes the step
- `touched`: List of files meaningfully modified