SuperAPI AI Directory

record-decision

Writing & research

View repository

Updated 10-16 02:35

About this skill

Take the decision as stated — no interview, no grilling. Write the ADR immediately.

Steps

  1. Scan for existing ADRs — check docs/adr/ for the highest existing number and increment. Create the directory if it doesn't exist.

  2. Write the ADR — follow the format in adr-format.md. One paragraph is enough.

  3. Update CONTEXT.md if relevant — if the decision establishes or changes the canonical name for a concept, or resolves a naming ambiguity in the codebase, update the relevant entry. If no CONTEXT.md exists, only create one if the decision is fundamentally about naming/terminology.

CONTEXT.md updates

Update only when the decision:

  • Establishes or changes the canonical name for a concept (e.g. "params" → CreateApplicationInput in the dto package)
  • Resolves a naming ambiguity in the codebase

Keep definitions to one sentence. List terms to avoid. Follow the existing file's format — don't restructure it.