Skip to content

imMamdouhaboammar/anti-slop-engineering / skills/repo-memory-and-invariant-steward

repo-memory-and-invariant-steward

Verified

Maintains the repository's architectural memory and enforces invariant preservation across sessions. Use when syncing historical decision records into a living compact Invariant Ledger, checking PRs/branches for architectural drift, verifying Gate 0 invariant constraints, or validating formal Reassessment Triggers — even if they don't explicitly say "invariant steward". Do NOT use for routine cosmetic edits or non-consequential scripts.

examples/decision-record-with-invariants.json

View on GitHub
{
  "schema_version": "1.0",
  "goal": "Migrate high-frequency checkout transaction processing to append-only event ledger with distributed deduplication",
  "decision_action": "proceed",
  "rationale": "Direct row-level update on inventory tables causes lock contention under 10M concurrent users. An append-only ledger eliminates write locks.",
  "invariants": [
    {
      "id": "INV-CHECKOUT-APPEND-ONLY",
      "category": "architecture",
      "assertion": "Checkout mutations must insert append-only immutable journal records rather than updating existing ledger balances.",
      "rationale": "Preserves audit trail and eliminates hot-row database lock contention.",
      "enforcement_scope": {
        "paths": [
          "src/ledger/**",
          "src/checkout/**"
        ],
        "patterns": [
          "INSERT INTO journal",
          "appendJournalEntry"
        ],
        "forbidden_patterns": [
          "UPDATE account_balance"
        ]
      },
      "status": "active",
      "reassessment_threshold": "Requires compliance team signoff and formal accounting audit."
    },
    {
      "id": "INV-CHECKOUT-DEDUPLICATION",
      "category": "concurrency_and_scale",
      "assertion": "Every incoming checkout request must validate unique transaction_token before journal dispatch.",
      "rationale": "Guarantees zero duplicate debit transactions during gateway retries.",
      "enforcement_scope": {
        "paths": [
          "src/checkout/gateway.ts",
          "src/api/checkout.ts"
        ],
        "patterns": [
          "transaction_token",
          "deduplicateToken"
        ],
        "forbidden_patterns": [
          "skipDeduplication"
        ]
      },
      "status": "active",
      "reassessment_threshold": "Requires proof of alternative idempotent wire protocol."
    }
  ],
  "author": "Mamdouh Aboammar",
  "created_at": "2026-11-10T18:00:00Z"
}
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall