From gangsta
Manages institutional memory in docs/gangsta/: reads/writes insights from successes, fails from mistakes, and Project Constitution with rules/constraints.
npx claudepluginhub kucherenko/gangsta --plugin gangstaThis skill uses the workspace's default tool permissions.
The Ledger is the Gangsta Agents Family's persistent memory. It stores successful reasoning pathways (Insights), documented failures (Fails), and accumulated governance rules (the Project Constitution). Every Heist reads from and writes to the Ledger.
Coordinates parallel subagents to document recently solved problems into searchable YAML-frontmatter Markdown files in docs/solutions/. Offers full research/cross-reference mode or lightweight single-pass.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Checks Next.js compilation errors using a running Turbopack dev server after code edits. Fixes actionable issues before reporting complete. Replaces `next build`.
Share bugs, ideas, or general feedback.
The Ledger is the Gangsta Agents Family's persistent memory. It stores successful reasoning pathways (Insights), documented failures (Fails), and accumulated governance rules (the Project Constitution). Every Heist reads from and writes to the Ledger.
The Ledger lives in the target project, NOT in the gangsta package:
docs/gangsta/
├── constitution.md # Project Constitution (living document)
├── insights/ # Repository of Insights (Good Catches)
│ └── YYYY-MM-DD-<topic>.md
└── fails/ # Repository of Fails (Concrete Shoes)
└── YYYY-MM-DD-<topic>.md
If docs/gangsta/ does not exist in the target project, create it:
mkdir -p docs/gangsta/insights docs/gangsta/fails
Create an initial docs/gangsta/constitution.md:
# Project Constitution
## Commandments (from Insights)
_No commandments yet. They will be added as Heists produce insights._
## Negative Constraints (from Fails)
_No constraints yet. They will be added as Heists document failures._
## Architectural Decisions
_No decisions recorded yet._
Criteria: Record when a solution bypasses a complex constraint, discovers a non-obvious approach, or establishes a new Project Commandment.
File: docs/gangsta/insights/YYYY-MM-DD-<topic-slug>.md
---
date: YYYY-MM-DD
heist: <heist-name>
phase: <phase-where-discovered>
tags: [tag1, tag2, tag3]
---
# <Title: Short description of the insight>
## Discovery
<How the insight was found — which phase, what triggered it>
## Solution
<The successful reasoning pathway or creative solution>
## Project Commandment
<If applicable: a new rule to add to the Constitution>
<If not applicable: omit this section>
After writing, update docs/gangsta/constitution.md:
— Source: insights/YYYY-MM-DD-<topic>.mdCriteria: Record when an approach caused regressions, security gaps, wasted time, or led to incorrect implementation.
File: docs/gangsta/fails/YYYY-MM-DD-<topic-slug>.md
---
date: YYYY-MM-DD
heist: <heist-name>
phase: <phase-where-occurred>
tags: [tag1, tag2, tag3]
severity: critical | high | medium | low
---
# <Title: Short description of the failure>
## What Happened
<Description of the failure and its observable impact>
## Cognitive Diagnosis
<Causal mechanism explaining WHY the failure occurred — not just what went wrong, but the reasoning error that led to it>
## Negative Constraint
<The explicit prohibition: "NEVER [prohibited pattern] because [reason]">
After writing, update docs/gangsta/constitution.md:
— Source: fails/YYYY-MM-DD-<topic>.mdSearch insights/ and fails/ for entries with tags matching the current Heist topic. Present relevant entries in the Reconnaissance Dossier.
The Devils-Advocate MUST check all Negative Constraints before accepting any proposal. If a proposal violates a Negative Constraint, it is automatically rejected.
The Underboss references Commandments when drafting the Contract. Every relevant Commandment must be cited in the Contract.
Workers check Negative Constraints before implementation. If a Work Package would violate a constraint, the Worker escalates to the Crew Lead.
New insights and fails from the Heist are written. The Constitution is updated.