Skip to content
Back to search

gangsta-marketplace

Development marketplace for Gangsta framework

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kucherenko--gangsta/badge.svg)](/listings/kucherenko--gangsta)

HTML

<a href="/listings/kucherenko--gangsta"><img src="/api/listings/kucherenko--gangsta/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Universal (any agent)

Install to all detected agents at once using the [skills CLI](https://github.com/vercel-labs/skills):

npx skills add kucherenko/gangsta

Install globally (available across all projects):

npx skills add kucherenko/gangsta --global

Install to a specific agent only:

npx skills add kucherenko/gangsta -a cursor
npx skills add kucherenko/gangsta -a claude-code
npx skills add kucherenko/gangsta -a opencode

Cursor

npx skills add kucherenko/gangsta -a cursor --global

Skills are installed to `~/.cursor/skills/` (global) or `.agents/skills/` (project).

Claude Code

/plugin marketplace add kucherenko/gangsta
/plugin install gangsta@gangsta-marketplace

GitHub Copilot

copilot plugin marketplace add kucherenko/gangsta
copilot plugin install gangsta@gangsta-marketplace

OpenCode

OpenCode 2.x:

opencode plugin add gangsta@git+https://github.com/kucherenko/gangsta.git

OpenCode 1.x, or for the full guide (pinning, updating, migrating from 1.x), tell OpenCode:

Fetch and follow instructions from https://raw.githubusercontent.com/kucherenko/gangsta/refs/heads/master/.opencode/INSTALL.md

Codex

Tell Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/kucherenko/gangsta/refs/heads/master/.codex/INSTALL.md

Gemini CLI

gemini extensions install https://github.com/kucherenko/gangsta

Antigravity CLI

agy plugin install https://github.com/kucherenko/gangsta

Installs the skills, the six subagents, and an always-on rule that loads the Gangsta bootstrap. Verify with `agy plugin list` and `agy agents`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "gangsta-marketplace",
  3. "description": "Development marketplace for Gangsta framework",
  4. "owner": {
  5. "name": "Andrey Kucherenko",
  6. "email": "kucherenko.andrey@gmail.com"
  7. },
  8. "plugins": [
  9. {
  10. "name": "gangsta",
  11. "version": "1.13.1",
  12. "source": "./"
  13. }
  14. ]
  15. }
README.md · README · 177 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="logo.svg" alt="Gangsta" width="200" />
  3. </div>
  4. # Gangsta Agents
  5. An AI agentic skills framework for spec-driven development, built on the organizational model of mafia.
  6. ## Philosophy
  7. Gangsta 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.
  8. **The Spec is Law.** Code is an implementation detail validated against the specification. No shadow hotfixes.
  9. **The Informed Minority.** Clear roles, clear hierarchy, clear accountability.
  10. ## How It Works
  11. When 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.
  12. ### The Heist Pipeline
  13. <img width="1200" height="655" alt="2026-04-23 16 47 21" src="https://github.com/user-attachments/assets/ef40d708-0369-4f8b-b144-57c4e3274cb0" />
  14. | Phase | Skill | What Happens | Gate |
  15. |-------|-------|-------------|------|
  16. | 1. **Reconnaissance** | `gangsta:reconnaissance` | Intel gathering on codebase and requirements | Dossier |
  17. | 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 |
  18. | 3. **The Sit-Down** | `gangsta:the-sit-down` | Formal spec drafting. No code allowed. | Contract |
  19. | 4. **Resource Development** | `gangsta:resource-development` | Task decomposition into Work Packages and Execution Plan | Execution Plan |
  20. | 5. **Execution** | `gangsta:the-hit` | Parallel execution by Worker subagents with TDD enforcement | Completion |
  21. | 6. **The Delivery** | `gangsta:laundering` | Verification, integration, and Ledger update | Ledger |
  22. Every phase gate requires your approval. You are the Don.
  23. → [Full Heist Pipeline documentation](docs/heist-pipeline.md)
  24. ### The Gangsta Agents Family Hierarchy
  25. | Role | Function |
  26. |------|----------|
  27. | **Don** (You) | Supreme authority. Approves all phase gates. |
  28. | **Consigliere** | Impartial advisor. Security and architecture auditor. |
  29. | **Underboss** | COO. Task decomposition, resource allocation. |
  30. | **Crew Lead** | Domain crew lead. Manages Workers per territory. |
  31. | **Worker** | Stateless code executor. TDD enforced. |
  32. | **Associate** | External tool/API proxy. |
  33. → [Full Hierarchy documentation](docs/hierarchy.md)
  34. ### The Family Ledger
  35. The Gangsta Agents Family maintains institutional memory across all Heists:
  36. - **Insights** — Successful reasoning pathways and creative solutions
  37. - **Fails** — Documented failures with cognitive diagnoses and negative constraints
  38. - **Constitution** — Accumulated commandments and prohibitions
  39. → [Full Ledger documentation](docs/ledger.md)
  40. ### Software Development Skills
  41. | Skill | Purpose |
  42. |-------|---------|
  43. | **Interrogation** | Systematic debugging — find the rat before applying fixes |
  44. | **The Drill** | TDD enforcement — no code without a failing test |
  45. | **Safehouse** | Git worktrees — isolated operational bases |
  46. | **The Audit** | Code review — the-inspector checks the work |
  47. | **Receiving Orders** | Process feedback with rigor, not blind agreement |
  48. | **The Sweep** | Verification — evidence before completion claims |
  49. | **Exit Strategy** | Branch integration and cleanup |
  50. → [Full Dev Skills documentation](docs/dev-skills.md)
  51. ### Omerta: Governance
  52. Five non-negotiable laws govern all operations:
  53. 1. **Introduction Rule** — No agent-to-agent communication without hierarchy mediation
  54. 2. **Rule of Availability** — All state checkpointed to files
  55. 3. **Rule of Truth** — Every claim cites its source. No invalid claims.
  56. 4. **Rule of Budget** — Resource budgets tracked and enforced
  57. 5. **Spec is Law** — Code contradicts spec → spec is revised first
  58. → [Full Omerta documentation](docs/omerta.md)
  59. ## Installation
  60. ### Universal (any agent)
  61. Install to all detected agents at once using the [skills CLI](https://github.com/vercel-labs/skills):
  62. ```bash
  63. npx skills add kucherenko/gangsta
  64. ```
  65. Install globally (available across all projects):
  66. ```bash
  67. npx skills add kucherenko/gangsta --global
  68. ```
  69. Install to a specific agent only:
  70. ```bash
  71. npx skills add kucherenko/gangsta -a cursor
  72. npx skills add kucherenko/gangsta -a claude-code
  73. npx skills add kucherenko/gangsta -a opencode
  74. ```
  75. ### Cursor
  76. ```bash
  77. npx skills add kucherenko/gangsta -a cursor --global
  78. ```
  79. Skills are installed to `~/.cursor/skills/` (global) or `.agents/skills/` (project).
  80. ### Claude Code
  81. ```bash
  82. /plugin marketplace add kucherenko/gangsta
  83. /plugin install gangsta@gangsta-marketplace
  84. ```
  85. ### GitHub Copilot
  86. ```bash
  87. copilot plugin marketplace add kucherenko/gangsta
  88. copilot plugin install gangsta@gangsta-marketplace
  89. ```
  90. ### OpenCode
  91. OpenCode 2.x:
  92. ```bash
  93. opencode plugin add gangsta@git+https://github.com/kucherenko/gangsta.git
  94. ```
  95. OpenCode 1.x, or for the full guide (pinning, updating, migrating from 1.x), tell OpenCode:
  96. ```
  97. Fetch and follow instructions from https://raw.githubusercontent.com/kucherenko/gangsta/refs/heads/master/.opencode/INSTALL.md
  98. ```
  99. ### Codex
  100. Tell Codex:
  101. ```
  102. Fetch and follow instructions from https://raw.githubusercontent.com/kucherenko/gangsta/refs/heads/master/.codex/INSTALL.md
  103. ```
  104. ### Gemini CLI
  105. ```bash
  106. gemini extensions install https://github.com/kucherenko/gangsta
  107. ```
  108. ### Antigravity CLI
  109. ```bash
  110. agy plugin install https://github.com/kucherenko/gangsta
  111. ```
  112. Installs the skills, the six subagents, and an always-on rule that loads the Gangsta bootstrap. Verify with `agy plugin list` and `agy agents`.
  113. ## Verify Installation
  114. Start a new session and say:
  115. > "I want to build a new feature"
  116. The agent should invoke Gangsta Agents skills automatically, starting with Reconnaissance.
  117. ## License
  118. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.