Question and scope
Define what is being compared and prevent unbounded research.
- question_id
- learner_question
- topic
- learning_level
- purpose
- scope_inclusions
- scope_exclusions
- requested_output
- due_at
- priority
Page actions
job / candidate
Source comparison — forms
The distinct forms record for Source comparison. This page is proposal-only.
Status: proposedLifecycle: candidate
Record status
- Record ID
- job:socrates:source-comparison
- Parent lifecycle
- candidate
- Page lane
- package
- Lane lifecycle
- proposed
- Owner
- Socrates
- Owner role
- University guide and tutor entity
- Owner status
- PROPOSED
- Qualification result
- NOT RUN · held for evidence and human review
Working browser surface: Agent jobs — builder overview — Inspect the package and stage a local project. This route is local-only; provider, credential, database, customer, publication, deployment, and production effects remain held.
Proposed form sections
Each section is a candidate schema for inspectable records. Required-field presence does not establish factual truth.
Source intake
Capture inspectable source identity without inventing or silently normalizing evidence.
- source_record_id
- title
- author_or_issuer
- publication_date
- source_type
- locator
- source_sha256
- provenance_note
- access_status
- relevant_excerpt
- attachment_reference
Claim extraction
Separate source wording from interpretation and record evidentiary status.
- claim_id
- source_record_id
- claim_text
- exact_quote_or_paraphrase
- location_in_source
- claim_type
- support_status
- confidence_label
- disputed_by
- interpretation_note
Comparison matrix
Make agreement, contradiction, difference in scope, and missing evidence explicit.
- comparison_id
- claim_group
- source_a_claim_id
- source_b_claim_id
- relationship
- agreement_summary
- difference_summary
- omission_summary
- unresolved_question
- evidence_needed
Learning path and handoff
Turn the comparison into bounded study actions while preserving authority limits.
- learning_goal
- ordered_activity_ids
- prerequisites
- reflection_prompts
- follow_up_sources
- human_review_required
- handoff_note
- result_lifecycle
Accessible state contract
- Every field requires a visible and programmatic label.
- Required and optional fields must be stated in text.
- Invalid entries require an actionable message linked to the field.
- Blocked and Held states remain visible without relying on color alone.
Supporting documentation fields
These fields come from the docs_urls lane and remain separate from the primary operating form.
Question and learning aim
Define what the learner is trying to understand before sources are compared.
- central question
- learner level or context
- learning objective
- known terms or definitions
- high-stakes topic flag
- desired output
Source inventory
Capture each source with provenance and enough context for inspection.
- source title
- author or issuing entity
- publication date if known
- source type
- source locator
- access or custody note
- source status
- source-specific limitation
Claim examination
Separate claims, evidence, interpretation, uncertainty, and disagreement.
- claim text
- claim owner or source
- supporting passage or locator
- evidence type
- confidence label
- disputed status
- counterevidence
- unresolved question
Comparison frame
Make the comparison criteria explicit rather than implying that one source is authoritative.
- comparison criteria
- scope alignment
- definitions alignment
- methods or evidence differences
- agreement summary
- material disagreement summary
- missing evidence
- inference warning
Inspectable learning path
Turn the comparison into bounded next steps that a learner can review and revise.
- ordered question sequence
- prerequisites
- reading or review tasks
- reflection prompts
- verification checkpoints
- stop or escalation condition
- learner review note
Human review and receipt
Record review state and preserve what was proposed, accepted, held, or rejected.
- reviewer
- review state
- decision note
- held items
- revision reason
- receipt or source hash if available
- next review date
Required or proposed record references
No record existence is asserted by this documentation page.
- source comparison job record with canonical ID, owner, lifecycle, provenance, source locator, source SHA-256 when available, revision, tags, links, and attachments
- one source record per compared item
- claim record for each material assertion, including support status and uncertainty note
- comparison matrix record containing matched claims, differences, omissions, and unresolved disputes
- question record defining the learner's inquiry and scope
- learning-path or field-guide record containing bounded steps and prerequisites
- review or approval record for any high-stakes, disputed, or publication-adjacent result
- todo records for evidence checks, follow-up questions, and review deadlines
- source-comparison job record
- source reference records
- claim records
- comparison notes
- learning-path project record
- review or approval record
- agent log receipt
Sources and evidence
These pointers bind the page to evidence. They do not grant authority or collapse verification into deployment.
agents/index.html#socratessource_record:job:socrates:source-comparisonobserved_native_contract:project_and_field_guide_collectionsobserved_native_contract:deadlinesobserved_native_contract:recordsobserved_native_contract:pointguardapp_route:/app/pointguard/app_route:/app/notebook/notes/app_route:/app/notebook/files/app_route:/app/notebook/projects/app_route:/app/notebook/approvals/app_route:/app/notebook/field-guides/app_route:/app/notebook/agent-logs/app_route:/app/notebook/search/app_route:/app/notebook/to-dos/app_route:/app/notebook/today/allowed_instruments:verified_clean_onlyobserved_native_contract:web_boundary