name: aitk-standards
description: Standards system and docs. Use when editing files in standards/ or docs/, including authoring conventions, install, and sync. Do not load this skill to read prose.md. Read it directly.
Standards
Read .claude/context/standards.md for system overview and install vs sync before editing.
Prose rules
Read .claude/standards/prose.md before writing or editing any prose in standards/ or docs/. It is the canonical voice and formatting reference.
Cross-references
- Do not reference one standard from another. Standards are loaded simultaneously by skills, so signpost links between them add noise without value.
- A functional cross-reference that changes behavior is allowed (for example, telling the reader which sibling standard still applies when a hook would otherwise skip the content). Bare signposts are not.
Sync checklist
When adding a standard:
- Create the
.mdfile instandards/followingstandards/standard.mdfor shape, frontmatter, and structure. - Update the standards table in
.claude/context/standards.md - Do not hand-edit
standards/index.md. It is generated byscripts/core/regen-indexes.sh(runs as part ofbun run check), and it fails if any standard is missing required frontmatter.
Reference
.claude/context/standards.md: system overview, install vs sync, adding standards.claude/standards/prose.md: full voice, structure, formatting, and language rules.claude/standards/standard.md: the meta-standard for a standard's shape, scope, and frontmatter
Generateur de Documentation API
Documentation
Genere automatiquement de la documentation API OpenAPI/Swagger.
Rédacteur Technique
Documentation
Rédige de la documentation technique claire selon les meilleurs style guides.
Architecture Decision Records (ADR)
Documentation
Cette compétence aide à documenter et gérer les décisions architecturales grâce à des modèles ADR structurés. Elle guide l'utilisateur dans le contexte, les facteurs de décision, les options et les conséquences des choix techniques. Utilisez-la lors de l'évaluation de nouveaux frameworks, technologies de base de données, conceptions d'API ou architectures de sécurité.