| name | aitk-prompts |
| description | System prompt templates for AI authoring. Use for adding prompts, editing role templates, or prompt conventions. |
Prompts
Read .claude/context/prompts.md for system overview and categories before editing.
Structure
- All-caps H1 title (
# BASH SCRIPT ARCHITECT), all-caps H2 sections (## ROLE, ## CRITICAL CONSTRAINTS), title case H3 subsections (### Must Do).
- Every prompt must include
## ROLE, ## CRITICAL CONSTRAINTS, ## OUTPUT FORMAT.
- Add
## VALIDATION when the output involves multi-step logic or edge cases. Omit for simple single-purpose prompts.
Content
- Prompts are machine-readable specs. Optimize for token efficiency and deterministic output, not prose readability.
- Every constraint must be verifiable from the output. No subjective qualifiers like "appropriate" or "well-structured".
- Do not duplicate general LLM knowledge. Focus on project-specific constraints and output shape.
- Use imperative voice throughout. "Do X", never "You should" or "Try to".
Exportable prompts
- When adding an exportable prompt, register it under the appropriate category in
prompts.toml using the file stem as the name.
essentials is the curated minimum for aitk prompts install. Keep it tight: only prompts that earn their weight on nearly every project. Slugs may overlap with other categories.
Sync checklist
When adding an exportable prompt:
- Create the
.md file in prompts/ starting with a frontmatter block carrying title and description. See .claude/standards/prose.md for the style rule.
- Add the name to the correct category in
prompts.toml
- If the prompt belongs in
essentials, also add it to the [essentials] section
- Update the prompts table and categories table in
.claude/context/prompts.md
- Do not hand-edit
prompts/index.md. It is generated by scripts/core/regen-indexes.sh (runs as part of bun run check), and it fails if any prompt is missing required frontmatter.
Reference
.claude/context/prompts.md: system overview, categories, CLI, heading conventions, required sectionsprompts/meta-prompt.md: system prompt generator template, output format, constraint patterns
