21 lines
1.2 KiB
Markdown
21 lines
1.2 KiB
Markdown
---
|
|
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.
|