SkillsHooksPromptsAgentsPersonasModelsPoliciesToolsTemplatesBundlesCategoriesStart here

Te · class template

Templates 10

Document skeletons a runtime fills. Each template carries the body with its {{placeholders}}, what each placeholder wants, the rules the finished document must obey, and one rendered example. The first set is the documents the convergent-systems constitution requires: README, ADR, runbook, HANDOFF, plan, commit message, pull request, postmortem.

10 of 10 shown
agentstable

Agent Definition (task-executing persona)

Template for an autonomous, one-shot subagent: frontmatter (name, description, tool allowlist, model), a numbered job, ranked priorities for when instructions conflict, shared-worktree discipline, a STATUS report contract, worked examples, red flags, a machine-readable RESULT_JSON line, and a capacity rule. For a conversational persona with a voice, use template/persona instead.

format
markdown
fills
22 placeholders
template/agentv1.0.0~/.ai/templates
adrstable

Architecture Decision Record (MADR 4.0.0)

The MADR 4.0.0 decision-record template: metadata, context and problem statement, decision drivers, considered options, decision outcome with consequences and confirmation, pros and cons per option, more information. One file per decision under docs/adr/. Sections marked optional in the comments may be deleted.

format
markdown
fills
23 placeholders
template/adrv1.0.2adr/madr
commit-messagestable

Commit Message

A Conventional Commits message: typed subject in the imperative under 72 characters, a body that explains why (not what) wrapped at 72, and the provenance trailer when an AI wrote significant code.

format
text
fills
5 placeholders
template/commit-messagev1.0.0ai-atoms
handoffstable

HANDOFF.md

Cross-session continuity document written at a context boundary: current state, next steps, open questions, files in flight, last known-good commit, audit references. The resuming session verifies every gating assertion against live state before acting on it.

format
markdown
fills
9 placeholders
template/handoffv1.0.0ai-atoms
planstable

Implementation Plan

A plan with an alternatives table, scope, numbered approach, tests, risks, dependencies, and backward compatibility. No TBD or TODO in the final draft. Required before non-trivial work starts.

format
markdown
fills
9 placeholders
template/planv1.0.0ai-atoms
postmortemstable

Incident Postmortem

A blameless postmortem written within 48 hours of resolution: impact, timeline, root cause, contributing factors, what went well, and dated action items with owners.

format
markdown
fills
11 placeholders
template/postmortemv1.0.0ai-atoms
personastable

Persona Definition (conversational character)

Template for a conversational, character-driven persona that holds a voice across many turns: who you are, how you speak, always/never behaviours, situation handling, how you think, ranked priorities, what is fixed versus what can shift, hard limits, staying in character under pressure, example exchanges, reading list, permitted change, and a closing restatement of the limits that never bend. For a one-shot task worker use template/agent.

format
markdown
fills
26 placeholders
template/personav1.0.0~/.ai/templates
pull-requeststable

Pull Request Description

A PR body a reviewer can act on: a summary that names the non-obvious decisions, what changed by area, a checkable test plan, and anything the reviewer should know before merging.

format
markdown
fills
4 placeholders
template/pull-requestv1.0.0ai-atoms
readmestable

README

The README every repository must have, answering four questions in order: what is this, who is it for, how do I run it, how do I contribute or extend it. Short by design; detail lives in linked documents.

format
markdown
fills
6 placeholders
template/readmev1.0.0ai-atoms
runbookstable

Runbook

The operations runbook every production system must have: what healthy looks like, what sick looks like, how to recover, whom to escalate to, and what on-call is expected to do. Every alert must map to an entry here.

format
markdown
fills
8 placeholders
template/runbookv1.0.0ai-atoms