Uncertainty marking — forms

The distinct forms record for Uncertainty marking. This page is proposal-only.

Status: proposedLifecycle: candidate

Record status

Record ID: job:socrates:uncertainty-marking
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.

Question and learning goal

Define the inquiry without presupposing an answer.

question_text
learning_goal
audience_level
subject_area
scope_inclusions
scope_exclusions

Evidence and sources

Capture inspectable source context and prevent unsupported attribution.

source_title
source_author_or_institution
source_locator
source_type
source_date
source_reference_or_file_link
source_sha256_if_available
quoted_or_paraphrased_passage
access_notes

Claim register

Separate facts, interpretations, hypotheses, and unresolved disputes.

claim_text
claim_category
confidence_label
supporting_source_ids
contradicting_source_ids
assumptions
known_limitations
last_reviewed_at

Comparison and synthesis

Make agreement, disagreement, and missing evidence visible.

comparison_basis
areas_of_agreement
areas_of_disagreement
method_or_definition_differences
missing_evidence
provisional_synthesis
alternative_interpretations

Learning path and review

Turn the inquiry into bounded, reviewable work.

ordered_learning_steps
prerequisites
learner_checks
review_owner
review_due_at
escalation_reason
approval_state

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 context

Define what the learner is trying to understand without assuming authority or filling gaps with invented facts.

question_text
learning_goal
course_or_topic_context
learner_level
known_constraints
desired_output_type

Sources and evidence

Capture inspectable source material and preserve provenance for later review.

source_title
source_type
source_locator
source_excerpt_or_summary
source_date_if_known
source_sha256_if_available
provenance_note
source_status

Claim and uncertainty marking

Separate claims from evidence and make disagreement, limitations, and unknowns visible.

claim_text
claim_scope
uncertainty_label
supporting_source_ids
contradicting_source_ids
reason_for_label
missing_evidence
last_reviewed_at

Learning path

Turn the inquiry into bounded, ordered steps with checks for understanding.

step_title
step_purpose
prerequisites
activity
expected_artifact
completion_condition
reviewer_or_owner

Boundary and review

Identify gates before material is treated as instruction, curriculum, or consequential advice.

high_stakes_flag
student_identity_data_present
external_enrollment_requested
published_curriculum_claim
human_review_required
approval_status
held_reason

Required or proposed record references

No record existence is asserted by this documentation page.

source-labelled notes for claims and evidence
file references for source materials
project record for the learning path
to-dos for review deadlines and unresolved questions
approval record for high-stakes or publishable claims
agent log recording authority, proposed actions, and receipts
canonical job record with owner_agent, owner_role, lifecycle, gates, and never rules
question note with learner wording and scope
source-labelled note for each supplied source or evidence item
claim record with confidence or uncertainty label and rationale
comparison record linking claims to sources
field-guide or project record for the learning path
todo records for review checkpoints
approval record for high-stakes or publication-sensitive output
agent-log record containing proposed work, authority boundary, and receipt

Sources and evidence

These pointers bind the page to evidence. They do not grant authority or collapse verification into deployment.

agents/index.html#socrates
source_record:job:socrates:uncertainty-marking
observed_native_contract.project_and_field_guide_collections
observed_native_contract.deadlines
observed_native_contract.records
observed_native_contract.pointguard
app_routes:/app/pointguard/
app_routes:/app/notebook/notes/
app_routes:/app/notebook/files/
app_routes:/app/notebook/to-dos/
app_routes:/app/notebook/approvals/
app_routes:/app/notebook/field-guides/
app_routes:/app/notebook/agent-logs/
app_routes:/app/notebook/search/
Observed native contract: project_and_field_guide_collections
Observed native contract: deadlines
Observed native contract: records
Observed native contract: pointguard
Observed native contract: web_boundary
App route: /app/notebook/notes/
App route: /app/notebook/field-guides/
App route: /app/notebook/approvals/
App route: /app/notebook/agent-logs/
App route: /app/pointguard/