imMamdouhaboammar/anti-slop-engineering / skills/repo-memory-and-invariant-steward
repo-memory-and-invariant-steward
VerifiedMaintains 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.4 KB |
| agents/openai.yaml | config | 338 B |
| evals/scenarios.json | config | 5.8 KB |
| examples/decision-record-with-invariants.json | config | 1.9 KB |
| examples/drift-violation-sample.diff | other | 558 B |
| examples/invariant-ledger-example.json | config | 4.3 KB |
| examples/reassessment-trigger-example.json | config | 997 B |
| playbooks/README.md | markdown | 2.0 KB |
| playbooks/drift-triage-playbook.md | markdown | 2.5 KB |
| playbooks/references/memory-anti-patterns.md | markdown | 2.3 KB |
| playbooks/steward-playbook.md | markdown | 2.1 KB |
| references/drift-detection-engine.md | markdown | 1.5 KB |
| references/gate0-memory-integration.md | markdown | 1.3 KB |
| references/invariant-ledger-contract.md | markdown | 1.8 KB |
| references/reassessment-protocol.md | markdown | 1.6 KB |
| usecases/drift-audit.md | markdown | 826 B |
| usecases/reassess.md | markdown | 1008 B |
| usecases/sync.md | markdown | 894 B |
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |