Skip to content

Walsworth-Group/physkit / skills/record-decision

record-decision

Verified

Record the why of a non-obvious decision: alternatives, reasons, dependencies, what would trigger a revisit.

FileKindSize
SKILL.mdskill md6.1 KB
assets/decision_template.mdmarkdown1.4 KB

assets/decision_template.md

View on GitHub
# Decision: <one-line title>

**Date:** <YYYY-MM-DD> · **Status:** active / superseded-by <link> · **Area:** <method / model / convention / tooling / approximation>

**Decision.** <What was chosen, concretely.>

**Alternatives considered.**
- <Option B> — <one line: what it was, why not>
- <Option C / do-nothing> — <one line>

**Why this one.** <The reasoning and the trade-off, tied to the real constraints (compute, accuracy,
fabrication, time, interpretability), and the evidence, if any.>

**Provenance.** *(mandatory)* <The source this decision is pinned to and its confidence: PINNED (a shipped
artifact / saved model / released data / empirical probe) / REPORTED (a paper/doc) / INFERRED (an untrusted
proxy: leftover/modified code) / RECALLED (memory) / REASONED (own judgment, no external fact). When it
rests on a fact from a source, resolve to the highest-authority source available and note lower-authority
sources that disagree and were quarantined. Flag an INFERRED/RECALLED load-bearing fact as not-yet-settled.>

**Conditions it depends on.** <The assumptions/regime that make this the right call: a parameter range, a
data property, a compute budget, a deadline.>

**Revisit-if.** <The concrete trigger that reopens this decision, for example: "if we leave the
dilute regime", "if the mesh exceeds 1e6 cells", "if validation data arrives".>

<!-- Related: [[frame-problem artifact]] · [[other decision]] -->
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall