imMamdouhaboammar/anti-slop-engineering / skills/cognitive-load-and-attention-governor
cognitive-load-and-attention-governor
VerifiedEnforce cognitive bandwidth and attention economy invariants across AI agent outputs, human-in-the-loop interactions, pull request descriptions, standalone deliverables, and multi-agent swarm handoffs. Governs scannability metrics (time-to-point, max wall length, landing anchor density), terminal blocking-question placement, deliverable purity (zero opener/closer fluff), working memory list bounding (Miller's law <= 5), and non-regression constraint preservation.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.1 KB |
| examples/attention-budget-record.json | config | 853 B |
| examples/pure-deliverable-sample.md | markdown | 300 B |
| playbooks/agent-to-agent-swarm.md | markdown | 2.0 KB |
| playbooks/human-agent-interaction.md | markdown | 2.7 KB |
| references/attention-metrics.md | markdown | 3.7 KB |
| references/handoff-contracts.md | markdown | 5.2 KB |
playbooks/agent-to-agent-swarm.md
View on GitHub# Playbook: Agent-to-Agent Swarm Attention Budgeting
This playbook defines protocols for managing attention budgets and context window preservation across multi-agent swarms (e.g. Fable, Jev, EGM Goldfish Reviewers).
---
## 1. The Context Inflation Hazard
In autonomous swarms, a coordinator agent delegates subtasks to worker agents. When workers return verbose responses (reasoning traces, raw tool logs, full file contents), the coordinator context window experiences rapid token inflation. This results in:
1. **Attention Decay:** Later decisions forget initial architectural invariants.
2. **Blocker Obscuration:** Critical failure codes get buried in long status prose.
3. **Runaway Cost:** Exponential growth in multi-turn token consumption.
---
## 2. The TOON Swarm Compression Protocol
All worker subagents must communicate state using compact TOON envelopes:
```toon
[SubagentExecutionReport] (schema: 1.0)
fields: 6
subagent_id: string
task_slug: string
outcome: enum(SUCCESS|BLOCKED|INCONCLUSIVE|FAILED)
metrics: map[string, number] (duration_ms, tests_passed, tests_failed)
terminal_blocker: optional[string]
artifacts_written: list[N] of string
```
### Invariants:
1. **Summary Before Diffs:** A subagent must never return a full file diff unless requested. It returns file path and line modification count.
2. **Terminal Escalation:** If the subagent encountered a blocking decision (e.g. API credential missing, migration collision), it must report `outcome: BLOCKED` and include `terminal_blocker` as the final field.
3. **Zero Affordance Meta-Text:** Subagents must not emit greetings, apologies, or conversational closers to other agents.
---
## 3. Coordinator Pruning Gate
Before appending subagent output to the persistent conversation transcript:
1. Verify that `attention_guard` passes with zero blockers.
2. If `longest_wall_words > 60`, automatically reformat into concise bullet points.
3. Strip all opener wrappers and closer offers before storing to disk.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |