docs-on-code-change git:20260324.7a91f3bA

Immutable. This exact content is served forever at /api/v1/blob/9ee37529811cf759.

---
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