git:20260324.7a91f3b to git:20260330.9f1fe92

---

description: Update docs (markdown) when code changes

alwaysApply: true

---

# Docs on Code Change

Whenever you write or change code that affects behavior, architecture, or APIs, you **must** update the relevant documentation in `docs/`.

## Scope

- New features, refactors, API changes, config changes, startup flow changes

- Applies to: `internal/`, `server/`, `domain/`, `scripts/`, `web/`, `bootstrap/`

## Actions

1. Identify which `docs/*_vi.md` files are impacted

2. Update them to match the new code (numbers, flows, endpoints, states, etc.)

3. Keep docs accurate — no drift between code and documentation

## Doc Files

| Code area | Docs to update |

|-----------|----------------|

| lamp-server, API, startup | `lamp-server_vi.md` |

| LED, effects, states, animations | `led-control_vi.md` |

| Setup flow, provisioning | `setup-flow_vi.md` |

| Web UI, configuration pages | `web-ui_vi.md` |

| Overall structure | `overview_vi.md` |

| MQTT, dispatch, publish | `mqtt_vi.md` |

| bootstrap, OTA | `bootstrap-server_vi.md` |

## Convention

- Vietnamese docs: `*_vi.md` (e.g. `lamp-server_vi.md`)

- English vision/design: keep as-is unless code explicitly changes behavior

- 100% accurate: numbers, names, flows must match code