{
  "contract": "pwm-catalog-uplift/1.0.0",
  "purpose": "Drive a premium, evidence-bounded PWM catalog refresh with fewer moving parts and explicit decision value.",
  "source_basis": [
    {"path": "state/pwm-catalog/parametric_skill_coverage_manifest.json", "role": "241-entry coverage input"},
    {"path": "state/pwm-catalog/catalog_claims_v1.json", "role": "current claim ledger"},
    {"path": "configs/pwm/skill_parameter_specs_v1.json", "role": "parameter contract input"},
    {"path": "/Users/benjaminbrown/.codex/.chatgpt-projects/g-p-6ab394f3654081918cca1edf0d46282a/outputs/talyx-five-spec-engineering-20260930/output/brand-asset/Talyx-Skills-Ecosystem-Field-Guide.html", "role": "premium interaction and type reference", "sha256": "11210ec49d62dc13ccdcd2504ef6ef08a763a7b90170b01be2c089ce9baebb8d", "hash_semantics": "historical_provenance_not_live_input"},
    {"path": "/Users/benjaminbrown/.codex/.chatgpt-projects/g-p-6ab394f3654081918cca1edf0d46282a/outputs/talyx-five-spec-engineering-20260930/output/pdf/Talyx-Skills-Ecosystem-Architecture-Field-Guide.pdf", "role": "print and page rhythm reference", "sha256": "793ce2bbc556ae097c89e2a80ba296fc735ad1bb9d9eb202817bec288b72d749", "hash_semantics": "historical_provenance_not_live_input"}
  ],
  "audit_axes": ["source authority", "identity grain", "parameter completeness", "runtime binding", "value measurement", "failure stop rules", "retrieval provenance", "UI discoverability", "responsive behavior", "release custody"],
  "top_10_prompt_design_approaches": [
    {"id": "P01", "name": "Decision First", "contract": "Require job, decision, deadline, and acceptable output before retrieval or generation."},
    {"id": "P02", "name": "Anchor Typed", "contract": "Require anchor kind, stable identifier, source date, and resolution state; never collapse advisor, team, firm, or product."},
    {"id": "P03", "name": "Evidence Ledger", "contract": "Bind every asserted fact to source pointer, observed time, claim ceiling, and truth state."},
    {"id": "P04", "name": "Stop Before Guess", "contract": "Make ambiguity, stale evidence, unsupported scope, and missing purpose terminal route states."},
    {"id": "P05", "name": "Smallest Useful Brief", "contract": "Return verified facts, material unknowns, decision questions, and one next action before optional enrichment."},
    {"id": "P06", "name": "Adapter Contract", "contract": "Specify input schema, output schema, failure semantics, owner, and runtime proof for every callable skill."},
    {"id": "P07", "name": "Counterfactual Check", "contract": "Ask what evidence would change the recommendation and include that test in the output."},
    {"id": "P08", "name": "Two-Speed Retrieval", "contract": "Use fast bounded retrieval for first value and deep retrieval only when the decision requires it."},
    {"id": "P09", "name": "Value Loop", "contract": "Capture baseline time, output quality, user correction, repeat use, and outcome after each pilot run."},
    {"id": "P10", "name": "UI as Contract", "contract": "Expose scope, status, provenance, and stop rules beside controls so the interface cannot imply unsupported certainty."}
  ],
  "four_user_questions": [
    {"question": "Which recurring PWM job should become the first measured habit after advisor meeting preparation?", "answer": "Real-time scheduling and batch orchestration of 9010 pre meeting intel plus 9010 Prospect Full Cycle."},
    {"question": "Which source systems are authoritative for advisor, team, firm, and product identity resolution, and how fresh must each source be?", "answer": "Neo4j plus OSINT/SOCMINT enrichment pipelines and regulatory filings; each claim carries source type and observation time."},
    {"question": "What is the minimum acceptable first brief?", "answer": "Full evidence packet, followed by one decision card, then a one-page meeting brief."},
    {"question": "Which outcome will decide promotion from pilot to routine?", "answer": "Speed to intelligence, hours saved, meeting quality, and information advantage measured through information asymmetry."}
  ],
  "pilot_decision": {
    "job_family": ["9010-pre-meeting-intel", "9010-prospect-full-cycle"],
    "execution_mode": ["REAL_TIME_SCHEDULED", "BATCH_ORCHESTRATED"],
    "authoritative_sources": ["neo4j", "osint_enrichment", "socmint_enrichment", "regulatory_filings"],
    "brief_sequence": ["FULL_EVIDENCE_PACKET", "DECISION_CARD", "ONE_PAGE_MEETING_BRIEF"],
    "promotion_metrics": ["SPEED_TO_INTELLIGENCE", "HOURS_SAVED", "MEETING_QUALITY", "INFORMATION_ASYMMETRY_ADVANTAGE"],
    "state": "DESIGN_ACCEPTED_RUNTIME_AND_VALUE_UNPROVEN"
  },
  "completion_gates": [
    "generator check passes",
    "HTML source-to-render readback matches 241 rows",
    "responsive and print CSS are present",
    "route stop states remain covered by tests",
    "pilot value remains UNMEASURED until a real brief and meeting outcome are observed"
  ]
}
