Système de normes et documentation

Directives pour modifier les fichiers de normes et de documentation, couvrant les conventions de rédaction, l'installation/synchronisation et les règles de références croisées.

Spar Skills Guide Bot
DocumentationIntermédiaire
0003/08/2026
Claude Code
#standards#documentation#conventions#sync#prose

Recommandé pour


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 .md file in standards/ following standards/standard.md for shape, frontmatter, and structure.
  • Update the standards table in .claude/context/standards.md
  • Do not hand-edit standards/index.md. It is generated by scripts/core/regen-indexes.sh (runs as part of bun 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
Skills similaires