core/docs/handoff
Shay 36cf14c436 docs(handoff): phase 3b+4 skeleton pack — tests + en_core_names_v1 starter
Self-contained skeleton dispatch under docs/handoff/phase-3b-4-skeleton/.
Nothing is collected by pytest, nothing is loaded by runtime.
Implementer moves files to live locations when wiring.

Contents:

  README.md
    Implementer workflow, target locations per file, pack notes.

  test_adr_0174_phase3b_compound_clause.py
    13 acceptance tests covering: pure conjunctive lists (2-clause
    proper noun, 5-clause pronoun w/ single antecedent), refusal
    discipline (mixed-verb, multiplicative-tail, non-whitelisted-verb,
    partial-grounding), HYPOTHESIS_CAP raise to 8, pronoun + multi-
    actor defense preservation, wrong=0 + case-0050 canary. All
    @pytest.mark.skip until implementation lands; imports inside
    test bodies so collection succeeds before target modules exist.

  test_adr_0174_phase4_contemplate.py
    16 acceptance tests covering: contemplate() primitive contract
    (empty/single-survivor noop), Resolution dataclass invariants
    (kind/source closed sets), gendered-pronoun resolution (the
    killer use case — 4 tests covering she/he/same-gender/unknown-
    name), evidence-source precedence (vault>pack>audit_history),
    determinism, trace event shape, wrong=0 + case-0050 canary.

  en_core_names_v1/gender.jsonl
    59 unambiguously-gendered English first names (30 female,
    29 male), alphabetically sorted, JSONL format with schema
    {name: str, gender: 'female'|'male'}. Covers names appearing
    in train_sample/v1 GSM8K problems (Alice, Bob, Daniel,
    Malcolm, Erica, Jan, Tina, etc.) plus common English
    first-name baseline.

  en_core_names_v1/manifest.json
    Pack metadata with sha256 checksum (verified against gender.jsonl
    bytes), entry count, schema declaration, ambiguity discipline
    (Jordan/Alex/Casey/Pat/Taylor/Morgan/Sam/Chris/Robin/Riley
    explicitly excluded), expansion pathway through HITL corridor,
    wrong=0 protection contract for the contemplate adapter.

Pack integrity verified:
  checksum match: True
  entry count match: True (59/59)
  no duplicates
  alphabetically sorted (deterministic diff)

References: docs/handoff/ADR-0174-PHASE-3B-4-COMBINED-SCOPE.md,
ADR-0174 (held-hypothesis comprehension), CLAUDE.md §Semantic Pack
Discipline.
2026-05-28 10:01:05 -07:00
..
phase-3b-4-skeleton docs(handoff): phase 3b+4 skeleton pack — tests + en_core_names_v1 starter 2026-05-28 10:01:05 -07:00
ADR-0084-pack-content-brief.md
ADR-0085-content-style-pass-brief.md docs(adr-0085): content style pass brief for the cheaper dev agent (#71) 2026-05-20 15:58:44 -07:00
ADR-0085-content-style-pass-v2-brief.md docs(adr-0085): content style pass v2 brief — 3sg + plural agreement (#75) 2026-05-20 16:23:14 -07:00
ADR-0167-FOLLOWUPS.md chore: remove stub injector + superseded docs (cleanup-as-you-find) (#373) 2026-05-27 11:08:14 -07:00
ADR-0167-PARALLEL-WORK-PLAN.md docs(ADR-0167): audit-as-teaching-evidence (math reader → contemplation wire) (#349) 2026-05-27 06:21:43 -07:00
ADR-0167-W2C-cross-domain-audit.md feat(ADR-0167/W2-C): domain discriminator + cross-domain audit (#351) 2026-05-27 06:44:29 -07:00
ADR-0172-TIER1-BRIEF-PACK.md docs(ADR-0172): fix evidence-module path in Tier 1 brief pack (#381) 2026-05-27 12:18:19 -07:00
ADR-0174-PHASE-3B-4-COMBINED-SCOPE.md docs(handoff): ADR-0174 Phase 3b + Phase 4 combined scope 2026-05-28 09:54:45 -07:00
BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md docs: Brief 11 EOD status footer + 2026-05-27 session narrative (#356) 2026-05-27 07:21:01 -07:00
CLEANUP-C2-run-lane-migration.md chore(audit): substrate cleanup — dead spike, gitignore, deprecation, reader diagnosis 2026-05-28 07:00:33 -07:00
CLEANUP-C4-compositions-compile.md chore(audit): substrate cleanup — dead spike, gitignore, deprecation, reader diagnosis 2026-05-28 07:00:33 -07:00
CODEX-domain-pack-closure-cleanup-brief.md docs(handoff): two Codex briefs — domain-pack closure cleanup + grc/he content phase II (#98) 2026-05-20 23:12:15 -07:00
CODEX-greek-hebrew-content-phase-ii-brief.md docs(handoff): two Codex briefs — domain-pack closure cleanup + grc/he content phase II (#98) 2026-05-20 23:12:15 -07:00
COMPOSITION-FRAME-CONSUMPTION-WIRING-BRIEF.md docs(consumption-wiring): brief for closing Frame + Composition loop halves (#396) 2026-05-27 16:14:50 -07:00
COMPOSITIONCLAIM-BRIEF-PACK.md docs(compositionclaim): brief pack — ADR-0169 doctrine + handler + heuristic tightening (#390) 2026-05-27 14:46:24 -07:00
COMPREHENSION-READER-AUDIT.md docs(brief-C): comprehension reader audit — zero eval delta diagnosis + next steps 2026-05-27 20:45:31 -07:00
CONSUMPTION-WIRING-DISPATCH-PACK.md docs(consumption-wiring): operator dispatch pack (CW-1 + CW-2) (#397) 2026-05-27 16:16:41 -07:00
DCS-S1-FINDING.md docs(ADR-0170): injector contract widening + DCS-S1 schema-gap finding (#372) 2026-05-27 10:51:46 -07:00
discrete_count_statement-injector-spec.md docs(handoff): reconcile discrete_count_statement injector spec (#366) 2026-05-27 09:51:30 -07:00
MATCHER-EXTENSION-DISPATCH-PACK.md docs(matcher-extension): dispatch pack (ME-1) (#399) 2026-05-27 16:17:30 -07:00
ME1-ME5-MILESTONE.md feat(matcher-extension/ME-5): integration smoke + ME-1..ME-5 milestone 2026-05-27 17:35:10 -07:00
POST-RAT1-PARALLEL-BRIEFS.md docs(post-rat1): four parallel dispatch briefs (B/C/D/E) 2026-05-27 20:24:39 -07:00
TIER2-AND-FRAMECLAIM-BRIEF-PACK.md docs(tier1.5+tier2): FrameClaim handler + Tier 2 W5 schema brief pack (#387) 2026-05-27 14:05:53 -07:00
VERB-EXPANSION-DISPATCH-PACK.md docs(handoff): require multi-actor pronoun safety test in VE-A/B acceptance 2026-05-28 09:19:46 -07:00
WAVE-NEXT-REVISED.md chore: remove stub injector + superseded docs (cleanup-as-you-find) (#373) 2026-05-27 11:08:14 -07:00
WORKBENCH-UI-WAVE-BRIEF-PACK.md docs(workbench-ui): wave brief pack (W1..W4) (#395) 2026-05-27 15:35:05 -07:00
WORKBENCH-UI-WAVE-SCOPING.md docs(workbench-ui): scoping brief for UI wave (W0..W4) (#392) 2026-05-27 15:09:58 -07:00