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 |
examples/invariant-ledger-example.json
View on GitHub{
"schema_version": "1.0.0",
"generated_at": "2026-11-10T18:00:00Z",
"invariants_count": 4,
"ledger_hash": "a1b2c3d4e5f67890123456789abcdef0123456789abcdef0123456789abcdef0",
"invariants": [
{
"id": "INV-PARANOID-IDEMPOTENCY",
"category": "concurrency_and_scale",
"assertion": "State-mutating POST/PUT/PATCH endpoints must enforce Idempotency-Key with persistent atomic storage.",
"rationale": "Eliminates duplicate transactions and race conditions under 10M concurrent sessions and network retries.",
"enforcement_scope": {
"paths": [
"src/api/**",
"src/controllers/**",
"src/routes/**",
"**/api/**"
],
"patterns": [
"Idempotency-Key"
],
"forbidden_patterns": [
"Math.random()"
]
},
"authority": {
"record_type": "paranoid_record",
"record_file": "skills/paranoid-principal-architect/examples/paranoid-architecture-record.json",
"record_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"author": "Mamdouh Aboammar"
},
"status": "active",
"reassessment_threshold": "Requires distributed idempotency benchmark and load-test verification."
},
{
"id": "INV-PARANOID-BOUNDED-READ",
"category": "concurrency_and_scale",
"assertion": "Database reads must be keyset-paginated with max_read_limit <= 50.",
"rationale": "Prevents memory exhaustion, latency spikes, and full-table-scan database brownouts.",
"enforcement_scope": {
"paths": [
"src/db/**",
"src/repositories/**",
"**/db/**"
],
"patterns": [
"limit",
"cursor"
],
"forbidden_patterns": [
"OFFSET 100",
"OFFSET 500"
]
},
"authority": {
"record_type": "paranoid_record",
"record_file": "skills/paranoid-principal-architect/examples/paranoid-architecture-record.json",
"record_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"author": "Mamdouh Aboammar"
},
"status": "active",
"reassessment_threshold": "Requires database index and query latency proof."
},
{
"id": "INV-OBSERVABILITY-CARDINALITY",
"category": "telemetry_and_slo",
"assertion": "Metric dimensions must remain bounded: dynamic IDs in label keys are strictly prohibited.",
"rationale": "Prevents metric storage explosion and OOMs in time-series telemetry systems.",
"enforcement_scope": {
"paths": [
"src/telemetry/**",
"src/metrics/**",
"**/observability/**"
],
"patterns": [
"histogram",
"counter"
],
"forbidden_patterns": [
"user_id",
"request_id",
"order_id"
]
},
"authority": {
"record_type": "observability_record",
"record_file": "skills/observability-and-slo-architect/examples/observability-slo-record.json",
"record_sha256": "c4ca4238a0b923820dcc509a6f75849b27ae41e4649b934ca495991b7852b855",
"author": "Mamdouh Aboammar"
},
"status": "active",
"reassessment_threshold": "Requires Monarch telemetry capacity review."
},
{
"id": "INV-ROLLOUT-WIRE-COMPAT",
"category": "rollout_and_compatibility",
"assertion": "Wire contracts must remain N-1/N+1 compatible: additive changes only and tolerant readers.",
"rationale": "Rejects atomic cutover fantasy and ensures zero downtime during rolling deployments.",
"enforcement_scope": {
"paths": [
"proto/**",
"schemas/**",
"src/contracts/**",
"api/**"
],
"patterns": [
"optional",
"reserved"
],
"forbidden_patterns": [
"required field removed"
]
},
"authority": {
"record_type": "rollout_record",
"record_file": "skills/safe-evolution-and-rollout-choreographer/examples/safe-evolution-record.json",
"record_sha256": "1679091c5a880faf6fb5e6087eb1b2dc27ae41e4649b934ca495991b7852b855",
"author": "Mamdouh Aboammar"
},
"status": "active",
"reassessment_threshold": "Requires multi-phase deprecation window and backwards compatibility gate."
}
]
}
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 |