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.
Badge for your README
Markdown
[](/listings/kucherenko--gangsta)HTML
<a href="/listings/kucherenko--gangsta"><img src="/api/listings/kucherenko--gangsta/badge.svg" alt="findsafeskills safety rating" /></a>Install
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)
- {
- "name": "gangsta-marketplace",
- "description": "Development marketplace for Gangsta framework",
- "owner": {
- "name": "Andrey Kucherenko",
- "email": "kucherenko.andrey@gmail.com"
- },
- "plugins": [
- {
- "name": "gangsta",
- "version": "1.13.1",
- "source": "./"
- }
- ]
- }
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)
- <div align="center">
- <img src="logo.svg" alt="Gangsta" width="200" />
- </div>
- # Gangsta Agents
- An AI agentic skills framework for spec-driven development, built on the organizational model of mafia.
- ## Philosophy
- 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.
- **The Spec is Law.** Code is an implementation detail validated against the specification. No shadow hotfixes.
- **The Informed Minority.** Clear roles, clear hierarchy, clear accountability.
- ## How It Works
- 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.
- ### The Heist Pipeline
- <img width="1200" height="655" alt="2026-04-23 16 47 21" src="https://github.com/user-attachments/assets/ef40d708-0369-4f8b-b144-57c4e3274cb0" />
- | Phase | Skill | What Happens | Gate |
- |-------|-------|-------------|------|
- | 1. **Reconnaissance** | `gangsta:reconnaissance` | Intel gathering on codebase and requirements | Dossier |
- | 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 |
- | 3. **The Sit-Down** | `gangsta:the-sit-down` | Formal spec drafting. No code allowed. | Contract |
- | 4. **Resource Development** | `gangsta:resource-development` | Task decomposition into Work Packages and Execution Plan | Execution Plan |
- | 5. **Execution** | `gangsta:the-hit` | Parallel execution by Worker subagents with TDD enforcement | Completion |
- | 6. **The Delivery** | `gangsta:laundering` | Verification, integration, and Ledger update | Ledger |
- Every phase gate requires your approval. You are the Don.
- → [Full Heist Pipeline documentation](docs/heist-pipeline.md)
- ### The Gangsta Agents Family Hierarchy
- | Role | Function |
- |------|----------|
- | **Don** (You) | Supreme authority. Approves all phase gates. |
- | **Consigliere** | Impartial advisor. Security and architecture auditor. |
- | **Underboss** | COO. Task decomposition, resource allocation. |
- | **Crew Lead** | Domain crew lead. Manages Workers per territory. |
- | **Worker** | Stateless code executor. TDD enforced. |
- | **Associate** | External tool/API proxy. |
- → [Full Hierarchy documentation](docs/hierarchy.md)
- ### The Family Ledger
- The Gangsta Agents Family maintains institutional memory across all Heists:
- - **Insights** — Successful reasoning pathways and creative solutions
- - **Fails** — Documented failures with cognitive diagnoses and negative constraints
- - **Constitution** — Accumulated commandments and prohibitions
- → [Full Ledger documentation](docs/ledger.md)
- ### Software Development Skills
- | Skill | Purpose |
- |-------|---------|
- | **Interrogation** | Systematic debugging — find the rat before applying fixes |
- | **The Drill** | TDD enforcement — no code without a failing test |
- | **Safehouse** | Git worktrees — isolated operational bases |
- | **The Audit** | Code review — the-inspector checks the work |
- | **Receiving Orders** | Process feedback with rigor, not blind agreement |
- | **The Sweep** | Verification — evidence before completion claims |
- | **Exit Strategy** | Branch integration and cleanup |
- → [Full Dev Skills documentation](docs/dev-skills.md)
- ### Omerta: Governance
- Five non-negotiable laws govern all operations:
- 1. **Introduction Rule** — No agent-to-agent communication without hierarchy mediation
- 2. **Rule of Availability** — All state checkpointed to files
- 3. **Rule of Truth** — Every claim cites its source. No invalid claims.
- 4. **Rule of Budget** — Resource budgets tracked and enforced
- 5. **Spec is Law** — Code contradicts spec → spec is revised first
- → [Full Omerta documentation](docs/omerta.md)
- ## Installation
- ### Universal (any agent)
- Install to all detected agents at once using the [skills CLI](https://github.com/vercel-labs/skills):
- ```bash
- npx skills add kucherenko/gangsta
- ```
- Install globally (available across all projects):
- ```bash
- npx skills add kucherenko/gangsta --global
- ```
- Install to a specific agent only:
- ```bash
- npx skills add kucherenko/gangsta -a cursor
- npx skills add kucherenko/gangsta -a claude-code
- npx skills add kucherenko/gangsta -a opencode
- ```
- ### Cursor
- ```bash
- npx skills add kucherenko/gangsta -a cursor --global
- ```
- Skills are installed to `~/.cursor/skills/` (global) or `.agents/skills/` (project).
- ### Claude Code
- ```bash
- /plugin marketplace add kucherenko/gangsta
- /plugin install gangsta@gangsta-marketplace
- ```
- ### GitHub Copilot
- ```bash
- copilot plugin marketplace add kucherenko/gangsta
- copilot plugin install gangsta@gangsta-marketplace
- ```
- ### OpenCode
- OpenCode 2.x:
- ```bash
- 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
- ```bash
- gemini extensions install https://github.com/kucherenko/gangsta
- ```
- ### Antigravity CLI
- ```bash
- 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`.
- ## Verify Installation
- Start a new session and say:
- > "I want to build a new feature"
- The agent should invoke Gangsta Agents skills automatically, starting with Reconnaissance.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.