Rebuild and maintain the standards index file (index.yml). Use after manually creating or deleting standards files, or if inject-standards suggestions seem out of sync.
Rebuild and maintain the standards index file (index.yml).
The index enables /inject-standards to suggest relevant standards without reading all files. It maps each standard to a brief description for quick matching.
.md files in agent-os/standards/ and its subfoldersroot/coding-style.md # Files in standards/ root use "root" as the folder name
root/naming.md
api/response-format.md
api/error-handling.md
database/migrations.md
Note: root is a reserved keyword — it refers to .md files directly in agent-os/standards/ (not in a subfolder). Do not create an actual folder named "root".
Read agent-os/standards/index.yml if it exists. Note which entries already have descriptions.
Compare the file scan with the existing index:
For each new standard file that needs an index entry:
New standard needs indexing:
File: api/response-format.md
Suggested description: "API response envelope structure and error format"
Accept? (yes / or type a better description)
Keep descriptions to one short sentence — they're for matching, not documentation.
If there are index entries for files that no longer exist:
Report: "Removed 2 stale index entries: api/old-pattern.md, testing/deprecated.md"
Generate agent-os/standards/index.yml with this structure:
folder-name:
file-name:
description: Brief description here
Rules:
.md extensionExample: