By kucherenko
Orchestrate spec-driven development with an AI agent hierarchy: enforce TDD cycles, run adversarial brainstorming for architecture, audit code changes via git SHAs, and maintain institutional memory with governance guardrails.
Run the autonomous Heist pipeline (Recon -> Grilling -> Sit-Down -> Resource-Development) for a feature; produces signed-by-don-proxy Contract and Plan
Sign and execute the most recent (or named) autonomous Heist's Hit + Laundering phases
Reject a pending-don-confirmation Heist; relocates its directory to docs/gangsta/.aborted/ with marker
Use this agent for specialized external tasks — codebase scanning, dependency audits, documentation retrieval, API integration, and other support work. Associates are not family members but provide essential services.
Use this agent during The Grilling to attack both the initial idea and proposed solutions. In Round 1, challenges the objective itself (problem framing, hidden assumptions, scope). In all rounds, finds architectural flaws, security gaps, constitution violations, and regression risks. Returns REJECT, CHALLENGE, or CONCEDE verdict.
Use this agent during The Grilling to propose architectural solutions based on the reconnaissance dossier. Must include inverse reasoning (self-identified risks) and constitution compliance.
Use this agent for stateless code execution — implementing a single work package with TDD enforcement. Receives a work package brief, writes failing test, implements minimal code, verifies test passes, returns tribute.
Use this agent during The Grilling to mediate between proposer and devils-advocate. Integrates valid attacks and don's feedback into revised solutions. Detects repetition and stronzate.
Use when completing tasks, implementing major features, or before merging — dispatches the-inspector to audit the books before the job is closed
Use ONLY when invoked via the `/gangsta:heist` or `/gangsta:go` commands (see `commands/heist.md` and `commands/go.md`) — orchestrates the Heist pipeline autonomously with `gangsta:don-proxy` substituting for the human Don across all six phases until the real Don signs via `/gangsta:go` or rejects via `/gangsta:abort`.
Invoked only by gangsta:autonomous-mode; substitutes for the human Don across all six Heist phases until /gangsta:go (sign) or /gangsta:abort (reject)
Use when implementing any feature or bugfix — enforces the Red-Green-Refactor drill with no production code allowed without a failing test first
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
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
An AI agentic skills framework for spec-driven development, built on the organizational model of mafia.
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.
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.
| 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 Multi-Agent Debate (Proposer vs Devils-Advocate, with you weighing in each round) | 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
The default Heist pauses for Don approval at every phase gate. Autonomous Mode is an opt-in fast path that delegates per-phase gating to a don-proxy surrogate while preserving the Don's terminal authority.
| Aspect | Default Heist | Autonomous Mode |
|---|---|---|
| Per-phase approval | Don at each gate | gangsta:don-proxy |
| Sit-Down sign-off | Don signs Contract | don-proxy signs as pending-don-confirmation |
| Sit-Down review | Consigliere advisory | Dual-Veto — Consigliere AND don-proxy, either REJECT is terminal |
| Terminal authority | Don | Don, via /gangsta:go (sign), /gangsta:abort (reject), Consigliere veto |
| Constitutional Floor | N/A | Mandatory rejection of artifacts violating Omerta or Negative Constraints |
Slash commands:
| Command | Purpose |
|---|---|
/gangsta:heist <feature> | Run Phases 1–4 (Reconnaissance → Grilling → Sit-Down → Resource-Development) autonomously. Produces don-proxy-signed Contract and Plan in pending-don-confirmation state. |
/gangsta:go [feature] | Don signing event. Flips pending-don-confirmation → confirmed, then runs Phases 5–6 (the Hit + Laundering). Resolves the most recent Heist via docs/gangsta/.last-heist when feature is omitted. |
/gangsta:abort <feature> | Rejects a pending Heist. Relocates docs/gangsta/<feature>/ to docs/gangsta/.aborted/<feature>-<timestamp>/ with an abort marker. Excluded from future ledger reads. |
Flags on /gangsta:heist:
--retries <1-10> (default 3) — per-phase retry budget before escalation--rounds <1-7> (default 3) — Grilling rounds; --rounds=1 is the minimum-cost fast path--best-effort <bool> (default true) — continue past non-terminal failures with deviation reportsLifecycle states for autonomous artifacts: pending-don-confirmation → confirmed (via /gangsta:go) or rejected (via /gangsta:abort). Constitutional Floor REJECTs are terminal in any phase and cannot be retried regardless of --best-effort.
Note: Autonomous Mode is positioned as a structured fast path, not a token-cost reduction. Mandatory adversarial Grilling is preserved — there is no flag to bypass it.
| Role | Function |
|---|---|
| Don (You) | Supreme authority. Approves all phase gates. |
| Consigliere | Impartial advisor. Security and architecture auditor. |
| Don-Proxy | Surrogate Don for autonomous mode. Bounded by the Constitutional Floor. |
| 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
npx claudepluginhub kucherenko/gangsta --plugin gangstaCore skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
Specification-driven development workflow: specify → plan → tasks → implement
Describe your goal, approve the spec, then step away — Claude and Codex loop together until it's right.
Spec-driven development using GitHub spec-kit methodology. Constitution-first approach with specify, plan, tasks, and implement phases.
Structured project planning and execution through brainstorm, spec, and build phases across three execution tiers: sequential, delegated sub-agents, and full agent teams
11 agents, 35 skills, 18 commands, 9 hooks — spec-driven multi-agent orchestration for Claude Code, with optional cross-device semantic memory.
Verification-first engineering toolkit for Claude Code. 15 skills across a 5-phase spine (Investigate → Design → Implement → Verify → Ship), 8 specialist agents, an interactive setup wizard. Every skill has rationalizations + evidence requirements. Built for senior ICs and tech leads.