{ "schema_version": "1.0.0", "evaluated_at": "2026-08-12", "status": "adopted_as_product_roadmap", "principle": "Using Super Técnico must be cheaper or materially more reliable than reconstructing the answer independently.", "implementation_policy": { "build_all_at_once": false, "phase_zero_before_remote_execution": true, "shared_engine_for_human_and_machine_clients": true, "database_direct_access": false, "bulk_export": false, "internal_costs_are_private": true, "public_results_are_compact": true, "new_tool_gate": [ "measurable_human_or_ai_value", "stable_inputs_and_outputs", "validation_method", "source_and_version_traceability", "acceptable_storage_and_compute_cost", "no_unnecessary_duplication" ] }, "phase_zero": { "title": "Gateway foundation and economic evidence", "requirements": [ "authentication_and_scopes", "versioned_tool_contracts", "source_ids_and_confidence", "rate_limits_and_anti_extraction", "cache_by_tool_and_version", "cost_latency_and_quality_telemetry", "blind_cost_and_accuracy_benchmark" ] }, "priority_now": [ "compact_context", "error_resolver", "component_compare", "measurement_validator", "deterministic_calculators" ], "tools": [ { "id": "compact_context", "name": "Knowledge Compact API", "family": "knowledge", "decision": "adopt_contract_now", "phase": 1, "current_state": "design_contract", "storage": "low", "compute": "low", "validation_risk": "medium", "existing_assets": ["coverage_preflight", "knowledge_record_schema", "source_ids", "compact_result_levels"], "next_step": "Implement projections that return only the minimum records and fields required for the stated objective.", "rationale": "Highest direct reduction of tokens, document reads and repeated retrieval." }, { "id": "error_resolver", "name": "Error Code Resolver", "family": "knowledge", "decision": "extend_existing", "phase": 1, "current_state": "browser_data_ready_api_planned", "storage": "medium", "compute": "low", "validation_risk": "medium", "existing_assets": ["30_brand_catalogs", "hvac_error_resolver_contract", "quality_reports", "source_documents"], "next_step": "Build a compact server projection that preserves brand, family, unit and display location.", "rationale": "The expensive data work already exists and remote projection offers immediate reuse." }, { "id": "manual_procedure", "name": "Manual to Procedure", "family": "knowledge", "decision": "extend_existing_after_provenance", "phase": 2, "current_state": "partial_structured_content", "storage": "medium", "compute": "low_after_extraction", "validation_risk": "high", "existing_assets": ["diagnostic_steps", "manufacturer_sources", "training_content"], "next_step": "Normalize procedures with exact model scope, source locator, safety warnings and review status.", "rationale": "Valuable, but a procedure with the wrong model scope is riskier than a missing result." }, { "id": "component_identifier", "name": "Component and board identifier", "family": "knowledge", "decision": "extend_existing", "phase": 2, "current_state": "browser_available_api_planned", "storage": "medium", "compute": "low", "validation_risk": "medium", "existing_assets": ["component_catalog", "smd_candidates", "pcb_oem_identifier"], "next_step": "Expose candidate identification without hiding ambiguity or historical status.", "rationale": "Existing normalized identifiers make this cheaper than a new image or document pipeline." }, { "id": "component_compare", "name": "Technical component comparison", "family": "compute_knowledge", "decision": "extend_existing", "phase": 1, "current_state": "browser_available_api_planned", "storage": "medium", "compute": "low", "validation_risk": "medium", "existing_assets": ["component_catalog", "comparison_ui", "comparison_tool_contract"], "next_step": "Return critical differences, missing evidence and application-specific incompatibilities.", "rationale": "High reuse and low marginal compute once the records are normalized." }, { "id": "datasheet_extract", "name": "Datasheet to structured record", "family": "knowledge", "decision": "defer_until_demand_and_licensing_gate", "phase": 4, "current_state": "reference_search_only", "storage": "high", "compute": "high_initial_low_reuse", "validation_risk": "high", "existing_assets": ["datasheet_finder", "basic_component_records"], "next_step": "Pilot only on high-reuse documents with permitted storage and a human verification queue.", "rationale": "It is economical only when the same verified extraction is reused many times." }, { "id": "case_matcher", "name": "Case Matcher", "family": "reasoning", "decision": "extend_existing_after_moderation", "phase": 2, "current_state": "browser_search_available_api_planned", "storage": "high", "compute": "medium", "validation_risk": "high", "existing_assets": ["field_case_search", "confirmed_case_flag", "community_backend"], "next_step": "Add structured symptoms, equipment scope, measurements and confirmed repair outcome.", "rationale": "Strong differentiation, but usefulness depends on moderation and confirmed outcomes." }, { "id": "next_best_test", "name": "Next Best Measurement", "family": "reasoning", "decision": "extend_existing_domain_by_domain", "phase": 2, "current_state": "refrigeration_browser_available", "storage": "low", "compute": "medium", "validation_risk": "high", "existing_assets": ["frigorista_get_next_measurement", "measurement_quality", "progressive_session"], "next_step": "Validate the refrigeration implementation before extending it to electrical and combustion diagnostics.", "rationale": "Reduces technician and AI iterations, but every domain needs its own evidence rules." }, { "id": "diagnostic_engine", "name": "Technical diagnostic engine", "family": "reasoning", "decision": "build_incrementally", "phase": 3, "current_state": "guided_diagnostics_partial", "storage": "medium", "compute": "medium", "validation_risk": "very_high", "existing_assets": ["hvac_diagnostic_steps", "frigorista_progressive_analysis", "field_cases"], "next_step": "Compose reviewed rules and validators; never infer refrigerant charge or safety conclusions from one measurement.", "rationale": "High value, but it must be assembled from validated tools instead of one opaque model call." }, { "id": "technical_validator", "name": "Technical Answer Validator", "family": "validation", "decision": "adopt_contract_now_execute_after_rule_coverage", "phase": 2, "current_state": "design_contract", "storage": "low", "compute": "medium", "validation_risk": "high", "existing_assets": ["knowledge_evidence_contract", "regulation_rule_contract", "quality_labels"], "next_step": "Validate decomposed claims against source IDs and deterministic rules, returning unsupported claims explicitly.", "rationale": "Valuable to AI clients, but it cannot be trustworthy before reviewed rule coverage exists." }, { "id": "measurement_validator", "name": "Measurement Validator", "family": "validation", "decision": "adopt_contract_now", "phase": 1, "current_state": "design_contract_with_domain_engines", "storage": "very_low", "compute": "low", "validation_risk": "medium", "existing_assets": ["frigorista_measurement_quality", "unit_contracts", "deterministic_calculators"], "next_step": "Implement unit, range, physical-consistency and cross-measurement checks by domain.", "rationale": "Excellent cost-to-value ratio and a prerequisite for safe diagnostics." }, { "id": "normalizer", "name": "Technical case normalizer", "family": "knowledge_validation", "decision": "defer_until_domain_schemas_stabilize", "phase": 3, "current_state": "partial_adapters", "storage": "very_low", "compute": "medium", "validation_risk": "medium", "existing_assets": ["electroia_request_adapter", "structured_tool_inputs"], "next_step": "Create separate schemas for refrigeration, electrical, combustion and field-service cases.", "rationale": "A universal normalizer built too early would erase important domain distinctions." }, { "id": "deterministic_calculators", "name": "Deterministic Calculators API", "family": "compute", "decision": "extend_existing", "phase": 1, "current_state": "multiple_browser_engines_available", "storage": "very_low", "compute": "low", "validation_risk": "medium", "existing_assets": ["frigorista_engine", "condensate_drain_engine", "duct_designer", "electrical_calculations"], "next_step": "Extract versioned pure functions and expose focused endpoints rather than one generic calculator.", "rationale": "Best immediate economics: tiny inputs and outputs, deterministic execution and high reuse." }, { "id": "simulation", "name": "Technical simulators", "family": "compute_reasoning", "decision": "defer", "phase": 4, "current_state": "not_planned_for_remote_release", "storage": "low", "compute": "high", "validation_risk": "very_high", "existing_assets": [], "next_step": "Reconsider only after demand, validation datasets and deterministic calculators are mature.", "rationale": "High infrastructure and validation cost before the simpler tools prove commercial demand." }, { "id": "quality_auditor", "name": "AI Quality Auditor", "family": "evaluation", "decision": "defer_until_benchmark_exists", "phase": 4, "current_state": "not_started", "storage": "low", "compute": "medium_high", "validation_risk": "high", "existing_assets": ["quality_reports", "evidence_labels"], "next_step": "Define a scored rubric only after blind benchmark cases and adjudicated answers exist.", "rationale": "An auditor without a trusted gold set would merely add another unverified opinion." }, { "id": "benchmark", "name": "HVAC/R AI Benchmark", "family": "evaluation", "decision": "build_internal_baseline_then_consider_product", "phase": 4, "current_state": "internal_plan_ready_baseline_pending", "storage": "high", "compute": "variable", "validation_risk": "high", "existing_assets": ["benchmark_plan", "benchmark_storage_schema"], "next_step": "Run the internal economic benchmark during phase zero; expose a B2B benchmark only after independent review.", "rationale": "The internal benchmark is mandatory now, while the commercial benchmark is a later product." } ] }