| name | readme-auto-sync |
| description | Mandatory rules for automatically updating README.md when creating files or tests. |
README Auto-Sync (BackEnd)
This skill defines the mandatory behavior of the AI agent regarding the maintenance of the Backend README.md file.
Context
To ensure the project documentation never becomes obsolete, the agent must proactively and automatically update the README.md whenever structural changes are made or test coverage is added.
Mandatory Rules (Guidelines)
-
Project Structure (Directory Tree):
- WHEN: Every time you create, move, or delete a file (
.cs, .json, .sql, etc.) or a directory.
- WHAT TO DO: You must run a command to list relevant files (like
Get-ChildItem -Recurse or your internal tool) and overwrite the "Project Structure" section in the README.md to reflect the exact current state. Ignore irrelevant folders like bin, obj, .vs, or .agent.
-
Test Counter:
- WHEN: Every time you create a new test file (
Tests.cs) or add/remove tests (xUnit) within an existing file.
- WHAT TO DO: You must run the testing suite (
dotnet test), read the console output to get the exact number of passed tests, and update the badge or the "Testing" section in the README.md.
Proactivity
DO NOT WAIT for the user to ask you to update the README. If your actions in a task involve creating or modifying the structure or tests, your final step in that task must be to update the README.md to reflect those changes before returning control to the user.