Forge Intelligence

Handbook

LCDL overlay: Health Navigation and Self-Care Support Intelligence

Design and test-contract bundle; no runtime implementation or operational certification is claimed. The manifest, schemas, validators, test suite, and task identities are complete enough for repository-native…

Updated

Runtime boundary

Design and test-contract bundle; no runtime implementation or operational certification is claimed. The manifest, schemas, validators, test suite, and task identities are complete enough for repository-native implementation; no placeholder task code is included.

Capability contracts

Capability ID Candidate task ID Required output artifacts Release validators
capability.life.health-navigation-self-care.organize_health_information intelligence_health_navigation_self_care_organize_health_information_v1 artifact.life.health-navigation-self-care.health_summary, artifact.life.health-navigation-self-care.symptom_timeline validator.life.health-navigation-self-care.01_urgent_red_flag_routing, validator.life.health-navigation-self-care.02_medication_change_prohibition, validator.life.health-navigation-self-care.03_local_source_and_guideline_freshness
capability.life.health-navigation-self-care.recognize_care_level intelligence_health_navigation_self_care_recognize_care_level_v1 artifact.life.health-navigation-self-care.care_route_decision validator.life.health-navigation-self-care.01_urgent_red_flag_routing, validator.life.health-navigation-self-care.03_local_source_and_guideline_freshness, validator.life.health-navigation-self-care.02_medication_change_prohibition
capability.life.health-navigation-self-care.prepare_appointment intelligence_health_navigation_self_care_prepare_appointment_v1 artifact.life.health-navigation-self-care.appointment_brief validator.life.health-navigation-self-care.02_medication_change_prohibition
capability.life.health-navigation-self-care.explain_care_plan intelligence_health_navigation_self_care_explain_care_plan_v1 artifact.life.health-navigation-self-care.care_plan_summary validator.life.health-navigation-self-care.04_care_plan_fidelity
capability.life.health-navigation-self-care.manage_medication_list intelligence_health_navigation_self_care_manage_medication_list_v1 artifact.life.health-navigation-self-care.medication_and_allergy_list validator.life.health-navigation-self-care.01_urgent_red_flag_routing, validator.life.health-navigation-self-care.02_medication_change_prohibition, validator.life.health-navigation-self-care.03_local_source_and_guideline_freshness
capability.life.health-navigation-self-care.plan_prevention_followup intelligence_health_navigation_self_care_plan_prevention_followup_v1 artifact.life.health-navigation-self-care.prevention_and_follow_up_plan validator.life.health-navigation-self-care.01_urgent_red_flag_routing, validator.life.health-navigation-self-care.02_medication_change_prohibition, validator.life.health-navigation-self-care.03_local_source_and_guideline_freshness
capability.life.health-navigation-self-care.monitor_and_escalate intelligence_health_navigation_self_care_monitor_and_escalate_v1 artifact.life.health-navigation-self-care.monitoring_log, artifact.life.health-navigation-self-care.health_escalation_record validator.life.health-navigation-self-care.01_urgent_red_flag_routing, validator.life.health-navigation-self-care.02_medication_change_prohibition, validator.life.health-navigation-self-care.03_local_source_and_guideline_freshness

Each capability contract in the manifest defines inputs, outputs, preconditions, postconditions, method-selection rules, invariant references, failure states, risk gate, metrics, and the existing forge-lcdl tasks/operators to compose.

Artifact schemas

Artifact type Schema reference Required payload fields Sensitivity
artifact.life.health-navigation-self-care.health_summary ../schemas/artifacts/health-navigation-self-care.schema.json#/$defs/health_summary subject_or_scope, purpose, facts_or_observations, preferences_and_constraints, source_refs, uncertainty, date_range, next_questions restricted
artifact.life.health-navigation-self-care.symptom_timeline ../schemas/artifacts/health-navigation-self-care.schema.json#/$defs/symptom_timeline events_or_legs, time_window, dependencies, deadlines, owners, buffers, contingencies, live_check_triggers restricted
artifact.life.health-navigation-self-care.care_route_decision ../schemas/artifacts/health-navigation-self-care.schema.json#/$defs/care_route_decision decision_id, decision_or_question, options_or_routes, governing_constraints, evidence_refs, rationale, status, owner, next_action, review_or_reopen_triggers restricted
artifact.life.health-navigation-self-care.appointment_brief ../schemas/artifacts/health-navigation-self-care.schema.json#/$defs/appointment_brief purpose, scope, stakeholders, requirements, constraints, assumptions, success_criteria restricted
artifact.life.health-navigation-self-care.care_plan_summary ../schemas/artifacts/health-navigation-self-care.schema.json#/$defs/care_plan_summary subject_or_scope, purpose, facts_or_observations, preferences_and_constraints, source_refs, uncertainty, date_range, next_questions restricted
artifact.life.health-navigation-self-care.medication_and_allergy_list ../schemas/artifacts/health-navigation-self-care.schema.json#/$defs/medication_and_allergy_list entries, entry_ids, owners, status, source_refs, updated_at restricted
artifact.life.health-navigation-self-care.monitoring_log ../schemas/artifacts/health-navigation-self-care.schema.json#/$defs/monitoring_log entries, entry_ids, owners, status, source_refs, updated_at restricted
artifact.life.health-navigation-self-care.prevention_and_follow_up_plan ../schemas/artifacts/health-navigation-self-care.schema.json#/$defs/prevention_and_follow_up_plan objective, scope, steps, dependencies, constraints, owners, timing, contingencies, review_triggers restricted
artifact.life.health-navigation-self-care.health_escalation_record ../schemas/artifacts/health-navigation-self-care.schema.json#/$defs/health_escalation_record decision_id, decision_or_question, options_or_routes, governing_constraints, evidence_refs, rationale, status, owner, next_action, review_or_reopen_triggers restricted

Validators

Validator ID Kind Automation Severity Failure action
validator.life.health-navigation-self-care.01_urgent_red_flag_routing deterministic_rule_and_classifier deterministic blocker escalate
validator.life.health-navigation-self-care.02_medication_change_prohibition policy hybrid blocker escalate
validator.life.health-navigation-self-care.03_local_source_and_guideline_freshness provenance hybrid major repair
validator.life.health-navigation-self-care.04_care_plan_fidelity semantic_comparison hybrid minor conditional_pass

Validator checks return itemized evidence and support pass, conditional_pass, fail, inconclusive, or a governed repair/escalation path. Generation does not self-certify.

Existing execution substrate

Tasks to reuse: contradiction_scan, decompose_problem, extract_schema_from_text, llm_boolean_gate, llm_enum_route, plan_decision_pack
Operators to reuse: branch, fallback_chain, for_each, optional_step, seq, try_catch, until_ok

Cross-intelligence handoff

  • artifact_id, type, version, producer capability, provenance, scope, assumptions, uncertainty, sensitivity, validation status, and next action
  • No free-text handoff may replace a required typed artifact when a downstream validator depends on structure.

Information-loss checks: - all hard constraints preserved - all blocker findings preserved - source scope and date preserved - assumptions and dissent preserved - units, time zones, identifiers, and uncertainty preserved

Evaluation and release

Suite: ../evaluation_suites/health-navigation-self-care.yaml

  • 100% schema validity for released artifacts
  • 100% material traceability
  • no unresolved blocker validator
  • no missed critical escalation in the approved benchmark
  • documented conditional-pass limits and human gates

Promotion to implementation maturity I1

  • Create repository-native input and output contracts for every candidate task ID.
  • Implement deterministic portions of validators and declare independent human or model review for semantic portions.
  • Connect a provenance-preserving source resolver and enforce freshness and jurisdiction rules.
  • Pass the per-pack suite and dependency regression suites at release thresholds.
  • Complete security, privacy, accessibility, and domain-owner review appropriate to risk.
  • Publish LMETA/LCDL exact-overlay links and CI parity checks.

Exact-overlay identity

The LMETA and LCDL pages share the concept ID, semantic version, capability IDs, and invariant IDs. tools/validate_pack.py checks this parity.

Paired overlay

Runtime maturity

  • Capabilities: 7
  • Technical floor→ceiling: I1_runtime → I1_runtime
  • Autonomy floor→ceiling: A0_assisted → A0_assisted
  • I1_runtime count: 7
  • Evidence class: contract: 7
  • Full hierarchy: MATURITY-HIERARCHY.md

Evaluation suite status

  • CI status: pass
  • Suite: evaluation_suites/health-navigation-self-care.yaml
  • Cases defined: 7
  • Capabilities under test: 7