update-living-docs

name	update-living-docs
description	Update living documents under docs/ (STATUS, DECISIONS, CONVENTIONS) based on conversation outcomes and implemented changes.

Update Living Docs

Update repository living docs after meaningful implementation or decision changes.

When To Use

Use this skill when the user asks to:

• update docs
• sync docs
• record decisions
• reflect latest progress in living docs

Target Docs

• docs/STATUS.md: progress, done/in-progress/backlog
• docs/DECISIONS.md: append-only technical decisions with IDs
• docs/CONVENTIONS.md: workflow/coding conventions when rules change

Workflow

1. Collect facts from current conversation and actual code changes.
2. Read current living docs.
3. Update only relevant sections.
4. Keep claims aligned with implemented reality (no future work as done).
5. Return a short summary of what changed.

Rules

• Prefer append/update over large rewrites.
• Keep decision entries structured and traceable (e.g. DEC-010).
• If nothing should change, explicitly say no doc update is needed.
• Do not invent completed work or test results.