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.

playbooks/drift-triage-playbook.md

View on GitHub
# Drift Triage & Remediation Playbook

> Operational guide for triaging, investigating, and resolving architectural drift violations flagged by the steward guard.

## 1. Drift Incident Response Flow

When `npx anti-slop-engineering steward drift --base HEAD` exits with code 2:

```
                  Drift Finding Reported
                            │
               ┌────────────┴────────────┐
               ▼                         ▼
      Accidental Regression    Intentional Architecture Change
               │                         │
               ▼                         ▼
        [Path A: Fix]             [Path B: Evolve]
   Revert violating edit or   File formal reassessment-trigger.json
   restore required tokens    with trade-off delta and load proof
               │                         │
               ▼                         ▼
       Re-run drift check       Run: steward reassess trigger.json
         (Must pass 0)         Pass drift check with --reassessment
```

---

## 2. Resolving Accidental Regressions (Path A)

1. Inspect the finding output:
   - Identify the `invariant_id` (e.g. `INV-PARANOID-IDEMPOTENCY`).
   - Note the `violating_line` or `removed_pattern`.
2. Locate the file in the PR diff.
3. Restore the required pattern (e.g. restore the `Idempotency-Key` validation check in the controller).
4. Remove any forbidden patterns (e.g. replace `Math.random()` with `crypto.randomUUID()`).
5. Re-run drift verification:
   ```bash
   npx anti-slop-engineering steward drift --base HEAD
   ```

---

## 3. Authoring an Official Reassessment Trigger (Path B)

If the change represents a planned, superior architectural evolution:

1. Draft `reassessment-trigger.json` following the schema.
2. Fill out:
   - `target_invariant_id`: exact ID from the ledger.
   - `action`: `supersede`, `waive`, or `deprecate`.
   - `justification`: comprehensive technical rationale.
   - `trade_off_delta`: explicit `gain` vs `risk`.
   - `authority`: author and PR/issue reference.
   - `verification_proof`: empirical evidence (e.g. load test result, benchmark, security audit).
3. Validate the record:
   ```bash
   npx anti-slop-engineering steward reassess reassessment-trigger.json
   ```
4. Run drift check with the reassessment trigger:
   ```bash
   npx anti-slop-engineering steward drift --base HEAD --reassessment reassessment-trigger.json
   ```
5. Merge the PR and run `steward sync` to update the ledger status.
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