SuperAPI AI Directory

resource-development

Coding & development

View repository

Updated 10-15 23:47

About this skill

Resource Development: Infrastructure and Tooling

Overview

The Underboss decomposes the signed Contract into Work Packages, sets up infrastructure for parallel execution, and produces the Execution Plan — the detailed task breakdown that governs The Hit.

Trigger

Invoked after the Don signs the Contract (The Sit-Down complete).

Process

Step 1: Decompose Contract into Work Packages

For each requirement in the Contract:

  1. Identify affected files (create/modify)
  2. Determine territory ownership (which Crew Lead)
  3. Define acceptance criteria (from Contract)
  4. Write verification command
  5. Estimate token budget

Each Work Package must be:

  • Independent — Can be implemented without waiting for other Work Packages (within the same territory, order may matter)
  • Verifiable — Has a specific test or command that proves it works
  • Bite-sized — 2-5 minutes of Worker tasks
  • Traceable — References a specific Contract clause

Step 2: Define Territories

Group Work Packages by domain and define Crew Lead territories:

## Territory: <Name>
**Domain:** <Description>
**Files:** <Glob patterns>
**Work Packages:** WP-001, WP-003, WP-007
**Workers:** <Parallel count>
**Budget:** <Token allocation>

Step 3: Set Up Isolation

If the project uses git:

  • Create a branch for the Heist: heist/<heist-name>
  • Optionally create worktrees per territory for true parallel work

If not:

  • Document the isolation strategy (directory copies, etc.)

Step 4: Verify Prerequisites

Before The Hit begins:

  • All existing tests pass on the current baseline
  • Required dependencies are available
  • File paths in Work Packages are valid
  • No merge conflicts with the base branch

Step 5: Produce Execution Plan

Compile everything into the Execution Plan.

Execution Plan Format

Save to: docs/gangsta/<heist-name>/plans/YYYY-MM-DD-execution-plan.md

---
heist: <heist-name>
date: YYYY-MM-DD
total-work-packages: <N>
territories: <N>
estimated-total-budget: <tokens>
---

# Execution Plan: <Heist Name>

## Territories

### Territory: <Name 1>
**Crew Lead Domain:** <description>
**Files:** <globs>
**Workers:** <N parallel>
**Budget:** <tokens>

### Territory: <Name 2>
...

## Work Packages

**Prevention Guidance (all Work Packages):** Do NOT reproduce Gangsta-internal spec identifiers (FR-xxx, NFR-xxx, WP-xxx, where xxx is one or more digits) in any deliverable — source code, test files, code comments, or documentation. These identifiers belong only in `docs/gangsta/`.

### WP-001: <Title>
**Territory:** <Name>
**Contract Clause:** <FR-NNN>
**Files:**
- Create: `path/to/file`
- Test: `tests/path/to/test`
**Acceptance Criteria:**
1. <criterion>
**Verification:** `<command>`
**Budget:** <tokens>
**Dependencies:** None | WP-XXX

### WP-002: <Title>
...

## Execution Order
1. Independent packages (can run in parallel): WP-001, WP-002, WP-005
2. Depends on group 1: WP-003 (needs WP-001)
3. ...

## Baseline Verification
- Tests: <PASS/FAIL — must be PASS>
- Dependencies: <OK/MISSING>
- Branch: heist/<heist-name> created from <base>

Step 6: Don Approves Execution Plan

Present to the Don:

"Execution Plan ready. Work Packages across territories. Estimated budget: . Ready to execute The Hit?"

Checkpoint

---
heist: <heist-name>
phase: resource-development
status: completed
timestamp: <ISO 8601>
next-action: Proceed to The Hit
artifacts:
  - docs/gangsta/<heist-name>/plans/YYYY-MM-DD-execution-plan.md
---

Omerta Compliance

  • Spec is Law: Every Work Package traces to a Contract clause
  • Rule of Budget: Token budgets allocated per territory
  • Rule of Availability: Execution Plan and checkpoint saved