Skip to content

dvy1987/agent-loom / .agents/skills/memory-decision

memory-decision

Verified

Record durable project decisions with rationale, alternatives, assumptions, status, and revisit triggers. Load when the user says record this decision, we decided, decision log, why did we choose, revisit this later, or capture architectural/process rationale.

Memory Decision

You record decisions so future agents understand not just what was chosen, but why it was valid at the time and when to reopen it.

Workflow

  1. State the decision in one sentence.
  2. Capture context: constraints, repo state, user preference, and date.
  3. List alternatives considered, including deferred options.
  4. Record rationale and tradeoffs.
  5. Define revisit triggers with concrete conditions.
  6. Set status: active, deferred, superseded, or retired.
  7. Append to docs/memory/decision-log.md.
  8. Update docs/memory/project-index.md.
  9. If architecture-wide, offer architectural-decision-log for an ADR.
  10. Log file outputs in docs/skill-outputs/SKILL-OUTPUTS.md.

Decision Template

## YYYY-MM-DD - <decision title>
Status: active | deferred | superseded | retired
Scope: project
Confidence: high | medium | low
Tags: <comma-separated>

### Decision
<what was chosen>

### Context
<what was true when this decision was made>

### Rationale
<why this is the right tradeoff now>

### Alternatives Considered
- <alternative>: <accepted/rejected/deferred and why>

### Revisit When
- <specific condition>

### Consequences
- <expected effect or risk>

Hard Rules

  • Never record a decision without at least one revisit trigger or "revisit not expected because ".
  • Do not overwrite old decisions; mark them superseded and link the replacement.
  • Do not confuse deferred with rejected.
  • If the user is still debating, write to deferred.md instead.

Example

Decision: use ~/.agent-loom/memories/ for global memory.

Revisit when: another cross-platform standard path is adopted or the user changes global storage policy.

Common Rationalizations

ExcuseReality
Skip memory — just codeNext agent loses decisions, blockers, and approved scope.
Load every memory fileRead indexes and handoff tail only — bounded context.
Global memory for everythingProject memory default; global only when stable and cross-project.
External paste → memoryRun secure-* first; transform to agent-authored notes.

Verification

  • Correct sub-skill routed with reason
  • No secrets or raw transcripts persisted
  • Files changed listed in Impact Report
  • Security gate noted when external content involved

Red Flags

  • Decision logged without revisit trigger or explicit none
  • Old decision overwritten instead of superseded link
  • Deferred item recorded as rejected decision
  • Rationale duplicated in handoff instead of decision-log link

Prune Log

Last pruned: 2026-07-04

  • No changes — citation audit passed; content current (improve-skills full pass 2026-07-04)

Impact Report

After completing, report:

Decision recorded: <title>
Location: docs/memory/decision-log.md
Status: <status>
Revisit triggers: <count>
ADR suggested: yes/no
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: 196kUpdated 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: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 193kUpdated 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: 193kUpdated Claude CodeCodexVerifiedInstall