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 just to read `prose.md`. Read it directly.

Standards

Read .claude/context/standards.md for system overview and install vs sync before editing.

Read .claude/standards/prose.md before writing or editing any prose in standards/ or docs/. It is the canonical voice and formatting reference.

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.

When adding a standard:

Create the .md file in standards/ following standards/bundled/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.

.claude/context/standards.md: system overview, install vs sync, adding standards
.claude/standards/prose.md: full voice, structure, formatting, and language rules
standards/bundled/standard.md: the meta-standard for a standard's shape and frontmatter
prompts/standards-reference.md: generator for the terse reference style, used for AI-assisted authoring

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 just to read `prose.md`. Read it directly.

Read .claude/context/standards.md for system overview and install vs sync before editing.

Read .claude/standards/prose.md before writing or editing any prose in standards/ or docs/. It is the canonical voice and formatting reference.

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.

When adding a standard:

Create the .md file in standards/ following standards/bundled/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.

.claude/context/standards.md: system overview, install vs sync, adding standards
.claude/standards/prose.md: full voice, structure, formatting, and language rules
standards/bundled/standard.md: the meta-standard for a standard's shape and frontmatter
prompts/standards-reference.md: generator for the terse reference style, used for AI-assisted authoring

aitk-standards