Documentation Review Guidance

Audit, improve, and maintain documentation quality across the repository. Search for doc files — don't rely on hardcoded paths.

Architecture Maintenance

For ARCHITECTURE-FLOW.md updates, load .github/skills/understanding-architecture/SKILL.md first — it has validation commands and source-of-truth mappings.

SKILL.md Quality Gates

Naming rules (agentskills.io spec):

• ✅ writing-csharp-code (lowercase, hyphens, max 64 chars)
• ❌ WritingCSharpCode | writing--csharp | -writing-code

Required frontmatter: name (must match directory name), description (must explain WHAT and WHEN, max 1024 chars)

Body must include: goal statement, practical code examples, common mistakes, related skill cross-references.

.agent.md Quality Gates