# Contributing to Gangsta

## What This Is

Gangsta is an AI agentic skills framework for spec-driven development. Skills are behavior-shaping code, not documentation. They must be tested rigorously.

## What Will NOT Be Accepted

- Third-party dependencies (this is a zero-dependency package)
- Changes that weaken Omerta governance rules
- Skills without adversarial pressure testing
- Bulk PRs with unrelated changes bundled together
- "Improvements" that add complexity without clear value
- Narrative storytelling in skill content (skills are instructions, not blog posts)

## Skill Changes

Every skill change requires:
1. Baseline testing: Run a pressure scenario WITHOUT the change, document behavior
2. Change testing: Run the same scenario WITH the change, document improvement
3. Include both results in your PR

## The Laws Apply to Contributors Too

- Omerta Law 3 (Rule of Truth): Every claim in a PR must be verifiable
- Omerta Law 5 (Spec is Law): Changes must align with the framework design spec

## The Constitutional Floor

Active Negative Constraints in `docs/gangsta/constitution.md` are binding on contributors. They are also binding on `gangsta:don-proxy` decisions under autonomous mode — the Don-Proxy cannot approve work that violates a Negative Constraint, regardless of `--best-effort`. Adding or modifying a Negative Constraint requires Don approval through a Heist; do not edit `docs/gangsta/constitution.md` directly in a PR without an associated Heist.

Autonomous mode does NOT relax the pressure-testing rule above. Skill changes shipped via `/gangsta:heist` still require baseline + change pressure-test results in the PR.