Updated 2mo ago
by kucherenko
gangsta
AI agentic skills framework for spec-driven development, built on the organizational model of mafia.
85 GitHub stars (85)
+2 in 20 days
| Period | New stars |
|---|---|
| Sep 27 | 0 |
| Sep 28 | 0 |
| Sep 29 | 0 |
| Sep 30 | +1 |
| Oct 1 | 0 |
| Oct 2 | +1 |
| Oct 3 | 0 |
| Oct 4 | 0 |
| Oct 5 | 0 |
| Oct 6 | 0 |
| Oct 7 | 0 |
| Oct 8 | 0 |
| Oct 9 | 0 |
| Oct 10 | 0 |
| Oct 11 | 0 |
| Oct 12 | 0 |
| Oct 13 | 0 |
| Oct 14 | 0 |
| Oct 15 | 0 |
| Oct 16 | 0 |
- 19 skills (19 skills found in its SKILL.md files)
- 11 forks (11 forks)
- 2mo ago last update (Last updated 2mo ago)
Install
Skills CLI
npx skills add kucherenko/gangsta
Asks which skills and agents to install. Just one: npx skills add kucherenko/gangsta --skill audit-review — add -g for every project.
Claude Code
git clone https://github.com/kucherenko/gangstacp -r "gangsta/skills/audit-review" ~/.claude/skills/
Copies the audit-review skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add kucherenko/gangsta
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
audit-review
Use when completing tasks, implementing major features, or before merging — dispatches the-inspector to audit the books before the job is closed
skills/audit-review/SKILL.md on GitHub (opens in a new tab) -
drill-tdd
Use when implementing any feature or bugfix — enforces the Red-Green-Refactor drill with no production code allowed without a failing test first
skills/drill-tdd/SKILL.md on GitHub (opens in a new tab) -
exit-strategy
Use when implementation is complete and all tests pass — guides the clean exit from a development branch with structured options for merge, PR, or cleanup
skills/exit-strategy/SKILL.md on GitHub (opens in a new tab) -
interrogation-debugging
Use when encountering any bug, test failure, or unexpected behavior — finds the rat in the code through systematic root-cause interrogation before any fix attempts
skills/interrogation-debugging/SKILL.md on GitHub (opens in a new tab) -
laundering
Use when all territories report completion after the hit — handles integration, verification, consigliere final review, cleanup, and ledger updates to produce clean production-ready code
skills/laundering/SKILL.md on GitHub (opens in a new tab) -
omerta
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
skills/omerta/SKILL.md on GitHub (opens in a new tab) -
receiving-orders
Use when receiving code review feedback — processes orders with technical rigor, not blind obedience or performative agreement
skills/receiving-orders/SKILL.md on GitHub (opens in a new tab) -
reconnaissance
Use when beginning a new heist — deploys associates to survey the target codebase, existing tests, dependencies, documentation, and the ledger to produce a reconnaissance dossier for the don's review
skills/reconnaissance/SKILL.md on GitHub (opens in a new tab) -
resource-development
Use when the contract is signed and work packages need to be created — decomposes the contract into bite-sized tasks, sets up git isolation, allocates territories and token budgets, producing the execution plan
skills/resource-development/SKILL.md on GitHub (opens in a new tab) -
safehouse-worktrees
Use when starting feature work that needs isolation from the current workspace — sets up a secure safehouse with git worktrees for clean operational bases
skills/safehouse-worktrees/SKILL.md on GitHub (opens in a new tab) -
sweep-verification
Use when about to claim work is complete, fixed, or passing — sweeps for evidence before any assertions, because unverified claims are invalid
skills/sweep-verification/SKILL.md on GitHub (opens in a new tab) -
the-capo
Use when orchestrating workers within a specific domain territory — managing work package dispatch, reviewing reports against the contract, and reporting status to the underboss
skills/the-capo/SKILL.md on GitHub (opens in a new tab) -
the-consigliere
Use when needing impartial architectural advice, security audit, spec integrity review, or a second opinion — operates outside the chain of command with standing authority to invoke truth checks
skills/the-consigliere/SKILL.md on GitHub (opens in a new tab) -
the-grilling
Use when adversarial brainstorming is needed after reconnaissance — the Proposer, Devils-Advocate, and Synthesizer each run ONE pass (no rounds); the Don is grilled on the IDEA first, one question at a time, then the proposal is attacked
skills/the-grilling/SKILL.md on GitHub (opens in a new tab) -
the-hit
Use when the execution plan is approved and it is time for parallel execution — dispatches workers through crew leads to implement work packages with TDD enforcement, report collection, and escalation protocols
skills/the-hit/SKILL.md on GitHub (opens in a new tab) -
the-ledger
Use when reading or writing institutional memory — insights from successful solutions, fails from historical mistakes, and the Project Constitution that accumulates commandments and negative constraints across heists
skills/the-ledger/SKILL.md on GitHub (opens in a new tab) -
the-sit-down
Use when the grilling consensus is approved and it is time to draft the formal contract specification — strictly prohibits code generation, produces the binding spec document that governs all subsequent phases
skills/the-sit-down/SKILL.md on GitHub (opens in a new tab) -
the-underboss
Use when decomposing tasks into work packages, allocating territories to crew leads, managing heist phase progression, or serving as the operational buffer between the Don and the crews
skills/the-underboss/SKILL.md on GitHub (opens in a new tab) -
using-gangsta
Use when starting any conversation — establishes how to find and use Gangsta skills, enforces the 1% invocation rule, maps platform tools, and routes the Don's intent through the Gangsta Agents Family hierarchy
skills/using-gangsta/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.