---
name: readme-structure-sync
description: Use this skill when changing files, folders, package scripts, routes, API modules, or project conventions in role-admin; it ensures README.md stays synchronized with the current repository structure.
---

# README Structure Sync

Use this skill whenever a task changes repository structure, important entry files, package scripts, routes, API modules, environment variables, or collaboration conventions.

## Workflow

1. Inspect the touched files and decide whether they affect `README.md`.
2. If directories or key files were added, removed, renamed, or moved, update the `README.md` directory map.
3. If `package.json` scripts changed, update the `README.md` important scripts table.
4. If business modules, API contracts, routes, or environment variables changed, update the matching README section.
5. Keep README descriptions short and operational: what the file or directory does, not a generic framework explanation.

## Touch-Up Rule

Do not scan the whole repository only for this skill. When a task already touches applicable files, fix obvious README drift in the same pass. If full cleanup is larger than the request, update the current workflow and top-level declarations, then call out the remaining gap.