obligation-team

Team-Based Obligation Test Generation: $ARGUMENTS

Spawn one agent per obligation. Each agent researches production code, writes a test to a temp file, runs it, fixes it until green, and reports back verified working code. Leader consolidates into the final test file and commits.

Architecture

• Agents: Research + write temp test file + run pytest + fix until green (parallel)
• Team lead: Consolidates verified tests into final file, quality gates, commit

Agents are full team members with shell access. They each write to their own temp file (tests/unit/_tmp_test_{OID_SUFFIX}.py) so there are no conflicts. The leader appends verified code to the shared test file after all agents report.

Protocol

Step 0: Resolve obligation IDs

Parse $ARGUMENTS to extract obligation IDs.

If prefix mode (args look like UC-004 --count 10 — no trailing sequence number):

python3 -c "
import json
al = json.loads(open('tests/unit/obligation_coverage_allowlist.json').read())
prefix = '$PREFIX'
matches = sorted(oid for oid in al if oid.startswith(prefix))
count = $COUNT  # default 10 if --count not specified
selected = matches[:count]
print('Selected obligations:')
for oid in selected:
    print(f'  {oid}')
print(f'Total matching: {len(matches)}, selected: {len(selected)}')
"

If direct IDs (args are full obligation IDs separated by spaces): Verify each ID exists in docs/test-obligations/ or the allowlist.

Store the resolved list as OBLIGATION_IDS.

Step 1: Gather shared context

Read these once — they'll be included in every agent's prompt:

1. Test file header (imports + helpers):

   # Identify the test file from the use case prefix
   # UC-004 → tests/unit/test_delivery_behavioral.py
   head -110 tests/unit/test_delivery_behavioral.py
   

2. Obligation scenarios for all resolved IDs:

   for OID in $OBLIGATION_IDS; do
     grep -A 30 "$OID" docs/test-obligations/*.md
   done
   

3. Production files to read (list for the agent prompt):

   • src/core/tools/media_buy_delivery.py
   • src/core/schemas/delivery.py
   • src/core/webhook_delivery.py
   • src/core/webhook_authenticator.py