{
  "markdown": "<div align=\"center\">\n  <img src=\"logo.svg\" alt=\"Gangsta\" width=\"200\" />\n</div>\n\n# Gangsta Agents\n\nAn AI agentic skills framework for spec-driven development, built on the organizational model of mafia.\n\n## Philosophy\n\nGangsta Agents replaces open-ended Agile iteration with a directive, vertical hierarchy. A small team of highly specialized agents — each operating with autonomy within their Position — outperforms a large pool of general-purpose agents.\n\n**The Spec is Law.** Code is an implementation detail validated against the specification. No shadow hotfixes.\n\n**The Informed Minority.** Clear roles, clear hierarchy, clear accountability.\n\n## How It Works\n\nWhen you start a session, the framework bootstraps The Don — an orchestrator that analyzes your intent and routes to the appropriate skill. When you want to build something, it initiates a **Heist**: a 6-phase operational cycle.\n\n### The Heist Pipeline\n<img width=\"1200\" height=\"655\" alt=\"2026-04-23 16 47 21\" src=\"https://github.com/user-attachments/assets/ef40d708-0369-4f8b-b144-57c4e3274cb0\" />\n\n| Phase | Skill | What Happens | Gate |\n|-------|-------|-------------|------|\n| 1. **Reconnaissance** | `gangsta:reconnaissance` | Intel gathering on codebase and requirements | Dossier |\n| 2. **The Grilling** | `gangsta:the-grilling` | Adversarial brainstorming via single-pass Multi-Agent Debate (idea grilled first, then Proposer vs Devils-Advocate, with you weighing in) | Consensus |\n| 3. **The Sit-Down** | `gangsta:the-sit-down` | Formal spec drafting. No code allowed. | Contract |\n| 4. **Resource Development** | `gangsta:resource-development` | Task decomposition into Work Packages and Execution Plan | Execution Plan |\n| 5. **Execution** | `gangsta:the-hit` | Parallel execution by Worker subagents with TDD enforcement | Completion |\n| 6. **The Delivery** | `gangsta:laundering` | Verification, integration, and Ledger update | Ledger |\n\nEvery phase gate requires your approval. You are the Don.\n\n→ [Full Heist Pipeline documentation](docs/heist-pipeline.md)\n\n### The Gangsta Agents Family Hierarchy\n\n| Role | Function |\n|------|----------|\n| **Don** (You) | Supreme authority. Approves all phase gates. |\n| **Consigliere** | Impartial advisor. Security and architecture auditor. |\n| **Underboss** | COO. Task decomposition, resource allocation. |\n| **Crew Lead** | Domain crew lead. Manages Workers per territory. |\n| **Worker** | Stateless code executor. TDD enforced. |\n| **Associate** | External tool/API proxy. |\n\n→ [Full Hierarchy documentation](docs/hierarchy.md)\n\n### The Family Ledger\n\nThe Gangsta Agents Family maintains institutional memory across all Heists:\n- **Insights** — Successful reasoning pathways and creative solutions\n- **Fails** — Documented failures with cognitive diagnoses and negative constraints\n- **Constitution** — Accumulated commandments and prohibitions\n\n→ [Full Ledger documentation](docs/ledger.md)\n\n### Software Development Skills\n\n| Skill | Purpose |\n|-------|---------|\n| **Interrogation** | Systematic debugging — find the rat before applying fixes |\n| **The Drill** | TDD enforcement — no code without a failing test |\n| **Safehouse** | Git worktrees — isolated operational bases |\n| **The Audit** | Code review — the-inspector checks the work |\n| **Receiving Orders** | Process feedback with rigor, not blind agreement |\n| **The Sweep** | Verification — evidence before completion claims |\n| **Exit Strategy** | Branch integration and cleanup |\n\n→ [Full Dev Skills documentation](docs/dev-skills.md)\n\n### Omerta: Governance\n\nFive non-negotiable laws govern all operations:\n\n1. **Introduction Rule** — No agent-to-agent communication without hierarchy mediation\n2. **Rule of Availability** — All state checkpointed to files\n3. **Rule of Truth** — Every claim cites its source. No invalid claims.\n4. **Rule of Budget** — Resource budgets tracked and enforced\n5. **Spec is Law** — Code contradicts spec → spec is revised first\n\n→ [Full Omerta documentation](docs/omerta.md)\n\n## Installation\n\n### Universal (any agent)\n\nInstall to all detected agents at once using the [skills CLI](https://github.com/vercel-labs/skills):\n\n```bash\nnpx skills add kucherenko/gangsta\n```\n\nInstall globally (available across all projects):\n\n```bash\nnpx skills add kucherenko/gangsta --global\n```\n\nInstall to a specific agent only:\n\n```bash\nnpx skills add kucherenko/gangsta -a cursor\nnpx skills add kucherenko/gangsta -a claude-code\nnpx skills add kucherenko/gangsta -a opencode\n```\n\n### Cursor\n\n```bash\nnpx skills add kucherenko/gangsta -a cursor --global\n```\n\nSkills are installed to `~/.cursor/skills/` (global) or `.agents/skills/` (project).\n\n### Claude Code\n\n```bash\n/plugin marketplace add kucherenko/gangsta\n/plugin install gangsta@gangsta\n```\n\n### GitHub Copilot\n\n```bash\ncopilot plugin marketplace add kucherenko/gangsta\ncopilot plugin install gangsta@gangsta-marketplace\n```\n\n### OpenCode\n\nTell OpenCode:\n\n```\nFetch and follow instructions from https://raw.githubusercontent.com/kucherenko/gangsta/refs/heads/master/.opencode/INSTALL.md\n```\n\n### Codex\n\nTell Codex:\n\n```\nFetch and follow instructions from https://raw.githubusercontent.com/kucherenko/gangsta/refs/heads/master/.codex/INSTALL.md\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/kucherenko/gangsta\n```\n\n## Verify Installation\n\nStart a new session and say:\n\n> \"I want to build a new feature\"\n\nThe agent should invoke Gangsta Agents skills automatically, starting with Reconnaissance.\n\n## License\n\nMIT\n",
  "bytes": 5498,
  "sha": "1f2f1ca169fb2a36a6071459a32ac88396db5bac18be6f4dc4a6fd8e868d2bbc",
  "repo_slug": "kucherenko/gangsta",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_kucherenko_gangsta_gangsta_95120151/readme"
}