ResearchContract
Jeff Smith edited this page 2026-04-08 14:37:37 -06:00

Page revisions

5 Commits

Author SHA1 Message Date
Jeff Smith
1f81471ce8 Add OpenQuestion to contract spec and examples
- New section documenting OpenQuestion (question, context, priority, source_locator)
- Direction table: gaps (backward), discovery_events (sideways), open_questions (forward)
- Updated all 3 examples to include open_questions
- Updated researcher rules (rule 5) and caller rules (rule 6)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-04-08 14:37:37 -06:00
Jeff Smith
e861c392e4 Add model_id to CostMetadata
Tracks which LLM powered each research call. Enables:
- Cost analysis across model tiers
- Quality calibration (confidence vs model capability)
- Reproducibility (know exactly what produced a result)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-04-08 12:49:03 -06:00
Jeff Smith
7ad91b7ca9 Update contract: raw_excerpt, categorized gaps, discovery events, confidence factors, content hashing
Incorporates architectural critique:
- raw_excerpt on citations prevents synthesis paradox (double-summarization)
- Gap categories (SOURCE_NOT_FOUND, ACCESS_DENIED, BUDGET_EXHAUSTED,
  CONTRADICTORY_SOURCES, SCOPE_EXCEEDED) enable PI to choose correct response
- discovery_events capture lateral findings for V2 orchestrator
- confidence_factors expose scoring inputs for future calibration
- content_hash (SHA-256) on trace fetches enables pseudo-CAS change detection
- Known Limitations table documents intentional V1 tradeoffs

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-04-08 12:28:10 -06:00
Jeff Smith
36bfe1813a Fix cross-wiki links to use /wiki/ routes
- Architecture.md: link to ResearchContract and DevelopmentGuide via wiki
- ResearchContract.md: link to Architecture and DevelopmentGuide via wiki
- DevelopmentGuide.md: link to Architecture and ResearchContract via wiki

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-04-08 12:07:33 -06:00
Jeff Smith
a349d6f970 Initial wiki: Architecture, ResearchContract, DevelopmentGuide
- Architecture: system overview, component design, data flow
- ResearchContract: complete tool specification with examples
- DevelopmentGuide: setup, testing, workflow, debugging

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-04-08 11:58:26 -06:00