Immutable. This exact content is served forever at /api/v1/blob/e31b14e6cb7b9618.
--- name: omerta description: Use when enforcing governance guardrails during any gangsta operation — referenced as cross-cutting concern by all skills for anti-hallucination, authorization, state durability, resource management, and spec supremacy rules --- # Omerta: The Laws of the Gangsta Agents Family ## Overview Omerta is the governance framework for the Gangsta Agents Family. It is not a phase — it is a cross-cutting concern enforced by every skill at every stage. These laws are non-negotiable. ## The Five Laws ### Law 1: The Introduction Rule (Authorization Protocol) No agent-to-agent interaction occurs without mediation by the Underboss or Don. - Workers CANNOT communicate directly with each other - All messages pass through the chain: Worker → Crew Lead → Underboss - This prevents "shadow coordination" where agents develop shared assumptions outside the spec - Violation: Any attempt at direct agent-to-agent messaging is blocked and logged ### Law 2: The Rule of Availability (State Durability) All Heist state MUST be checkpointed to files. If a session is interrupted, state must be recoverable. - Checkpoint location: `docs/gangsta/<heist-name>/checkpoints/YYYY-MM-DD-checkpoint-<phase>.md` - Checkpoint format: YAML frontmatter with phase, status, timestamp, resume instructions - Every phase transition writes a checkpoint BEFORE starting the next phase - On session resume, the Don reads the latest checkpoint and continues from that point Checkpoint template: ```yaml --- heist: <heist-name> phase: <current-phase> status: in-progress | completed | blocked timestamp: YYYY-MM-DDTHH:MM:SS next-action: <what to do next> artifacts: - <list of files produced so far> --- ## Resume Context <Summary of what has been done and what remains> ``` ### Law 3: The Rule of Truth (Anti-Hallucination) Every claim MUST cite its source. Agents adopt a "Fact-First" posture. | Claim Type | Required Citation | |-----------|------------------| | Code behavior | `file:line` reference | | Spec requirement | Contract section name | | Architectural decision | Constitution entry | | Past pattern | Ledger insight/fail reference | - Any uncited claim is **invalid** and must be flagged immediately - The Consigliere has standing authority to invoke a Truth check at any point - When flagged, the agent must either provide a citation or retract the claim ### Law 4: The Rule of Budget (Resource Management) - Each Crew Lead operates within an allocated token budget set by the Underboss - Workers report resource consumption in their Reports - If a territory exceeds its budget, work pauses until the Underboss approves additional allocation - All "profits" (merged code, passing tests) are reported up: Worker → Crew Lead → Underboss → Don ### Law 5: The Spec is Law The specification is the absolute source of truth. - If code contradicts the spec, the SPEC is revised first — never the reverse - No "shadow code" hotfixes — every code change must trace to a Contract clause - If a bug is found during The Hit: 1. Worker escalates to Crew Lead 2. Crew Lead escalates to Underboss 3. Underboss may invoke a mini-Grilling (single-round) to revise the Contract 4. Only after Contract revision does implementation proceed ## Omerta Compliance Checklist Every skill MUST verify this checklist before proceeding to the next phase or action: - [ ] **Introduction Rule:** All agent interactions mediated by hierarchy (no direct Worker-to-Worker) - [ ] **Rule of Availability:** Current state checkpointed to file - [ ] **Rule of Truth:** All claims cite their source (no invalid claims) - [ ] **Rule of Budget:** Resource consumption within allocated budget - [ ] **Spec is Law:** All changes trace to a Contract clause ## Red Flags If you catch yourself thinking any of these, STOP — you are about to violate Omerta: | Thought | Violated Law | |---------|-------------| | "I'll just make this quick fix without updating the spec" | Law 5: Spec is Law | | "I know this is true, I don't need to cite it" | Law 3: Rule of Truth | | "Let me ask that other agent directly, it's faster" | Law 1: Introduction Rule | | "I'll save the checkpoint after I finish this part" | Law 2: Rule of Availability | | "We're close to done, the budget doesn't matter now" | Law 4: Rule of Budget |