Skip to content

Design

G6 design assurance component.

Cluster: Uncategorised | Type: component | MCP Tools: None

Overview

Design assurance component for G6 reliability QA. It inventories every repo-native component and deployment project, generates componentwise and deployment-specific failure modes, maps them to mitigation strategies, evaluates human-centered specs, and provides release gates for UAT, self-verification, cost/token realism, professional standards, Poka-Yoke coverage, and optimal G6 block selection.

When to use:

  • Checking whether a component or deployment has human-usable QA coverage before release
  • Generating baseline failure-mode and mitigation catalogues across components/mvp and projects
  • Enforcing spec and release gates for UAT, verification evidence, resource constraints, and user-goal fit
  • Advising which G6 blocks should be used for a goal before execution

Works well with: guide, navigator, hat_orchestrator, reliability, poka_yoke, align_specs, align_evals, token_budget, system_doctor

Public API

DesignBlock(AIBlock[DesignInput, DesignOutput, dict])

Generate and evaluate human-centered QA coverage for G6 components/projects.

Field Type Default
name str 'design'
state dict[str, Any] field(default_factory=dict)

Methods:

infer(data: Any) -> Result[DesignOutput]

DesignInventoryItem(BaseModel)

Field Type Default
name str required
kind BrickKind required
path str required
domain str 'general'
tier str 'baseline'
user_facing bool False
high_risk bool False
summary str ''
caveats list[str] Field(default_factory=list)
tags list[str] Field(default_factory=list)

DesignFailureMode(BaseModel)

Field Type Default
failure_code str required
title str required
symptom str required
trigger_conditions list[str] Field(default_factory=list)
root_cause str ''
mitigation_strategy str ''
prevention_checklist list[str] Field(default_factory=list)
verification_evidence list[str] Field(default_factory=list)
poka_yoke_categories list[str] Field(default_factory=list)
gate_impact GateVerdict 'warn'

DesignGateFinding(BaseModel)

Field Type Default
code str required
verdict GateVerdict required
message str required
mitigation str required

TaskContract(BaseModel)

Field Type Default
specific str ''
measurable list[str] Field(default_factory=list)
achievable bool False
relevant str ''
time_resource_bound str ''
audience str ''
constraints dict[str, Any] Field(default_factory=dict)
available_data list[str] Field(default_factory=list)
non_goals list[str] Field(default_factory=list)
stopping_rule str ''

PremortemCheck(BaseModel)

Field Type Default
failure_mode str required
diagnostic_question str required
guardrail str required
likely bool False
severity GateVerdict 'warn'

EpistemicContract(BaseModel)

Field Type Default
domain str 'general'
evidence_standard str ''
verification_strategy str ''
forbidden_evidence list[str] Field(default_factory=lambda: ['model confidence alone'])
escalation_triggers list[str] Field(default_factory=list)

VerificationResult(BaseModel)

Field Type Default
method str required
status VerificationStatus 'not_run'
evidence list[str] Field(default_factory=list)
gaps list[str] Field(default_factory=list)
corrective_action str ''

ExecutableCheck(BaseModel)

Field Type Default
name str required
command list[str] Field(default_factory=list)
cwd str ''
timeout_sec int 30
required bool True

ExecutableCheckResult(BaseModel)

Field Type Default
name str required
command list[str] Field(default_factory=list)
status ExecutableCheckStatus 'skipped'
exit_code int \| None None
stdout_tail str ''
stderr_tail str ''
reason str ''

WarningCard(BaseModel)

Field Type Default
reliability_status ReliabilityStatus 'amber'
why_status list[str] Field(default_factory=list)
main_risks list[str] Field(default_factory=list)
what_verified list[str] Field(default_factory=list)
what_not_verified list[str] Field(default_factory=list)
recommended_next_step str ''

BlockContract(BaseModel)

Field Type Default
block_name str required
purpose str ''
inputs_required list[str] Field(default_factory=list)
inputs_optional list[str] Field(default_factory=list)
preconditions list[str] Field(default_factory=list)
outputs list[str] Field(default_factory=list)
good_at list[str] Field(default_factory=list)
bad_at list[str] Field(default_factory=list)
known_failure_modes list[str] Field(default_factory=list)
cost_token_estimate str ''
verification_method str ''
human_review_required bool False
stop_conditions list[str] Field(default_factory=list)
fallback_block_or_workaround str ''

ProfessionalStandard(BaseModel)

Field Type Default
domain str 'general'
assurance_strength CompletionState 'qualified-draft'
expert_review_attached bool False
applicable_professional_standards list[str] Field(default_factory=list)
regulatory_or_ethical_constraints list[str] Field(default_factory=list)
evidence_standard str ''
common_ai_failure_modes list[str] Field(default_factory=list)
required_sources_tools list[str] Field(default_factory=list)
required_review_level str ''
forbidden_claims list[str] Field(default_factory=list)
human_expert_escalation_triggers list[str] Field(default_factory=list)
example_good_output str ''
example_unsafe_output str ''

TaskReliabilityAssessment(BaseModel)

Field Type Default
completion_state CompletionState 'qualified-draft'
reliability_status ReliabilityStatus 'amber'
risk_tier RiskTier 'R1'
current_stage ReliabilityStage 'human_handoff'
task_contract TaskContract Field(default_factory=TaskContract)
premortem list[PremortemCheck] Field(default_factory=list)
epistemic_contract EpistemicContract Field(default_factory=EpistemicContract)
verification_results list[VerificationResult] Field(default_factory=list)
executable_check_results list[ExecutableCheckResult] Field(default_factory=list)
risk_reasons list[str] Field(default_factory=list)
assumptions list[str] Field(default_factory=list)
residual_risks list[str] Field(default_factory=list)
missing_inputs list[str] Field(default_factory=list)
next_actions list[str] Field(default_factory=list)
warning_card WarningCard Field(default_factory=WarningCard)

DesignInput(BaseModel)

Field Type Default
operation DesignOp 'inventory'
workspace_root str ''
target str ''
target_kind BrickKind \| Literal['all'] 'all'
include_projects bool True
include_components bool True
deep bool False
persist_to_reliability bool False
reliability_db_path str ''
spec dict[str, Any] Field(default_factory=dict)
goal str ''
domain str 'general'
constraints dict[str, Any] Field(default_factory=dict)
evidence dict[str, Any] Field(default_factory=dict)
verification dict[str, Any] Field(default_factory=dict)
claims list[dict[str, Any]] Field(default_factory=list)
executable_checks list[ExecutableCheck] Field(default_factory=list)
run_checks bool False
incident_component str 'design'
block_name str ''
expert_review_attached bool False
output_format Literal['json', 'markdown'] 'json'
request_id str ''
task_id str ''
run_id str ''

DesignOutput(BaseModel)

Field Type Default
operation str ''
ok bool True
error str ''
inventory list[DesignInventoryItem] Field(default_factory=list)
failure_modes dict[str, list[DesignFailureMode]] Field(default_factory=dict)
findings list[DesignGateFinding] Field(default_factory=list)
verdict GateVerdict 'pass'
recommendations list[str] Field(default_factory=list)
report str ''
assessment TaskReliabilityAssessment \| None None
warning_card WarningCard \| None None
block_contract BlockContract \| None None
professional_standard ProfessionalStandard \| None None
verification_results list[ExecutableCheckResult] Field(default_factory=list)
incident_id str ''
metadata dict[str, Any] Field(default_factory=dict)
completion_state CompletionState 'qualified-draft'
evidence dict[str, Any] Field(default_factory=dict)
request_id str ''
task_id str ''
run_id str ''
available_with list[str] Field(default_factory=lambda: ['direct'])
backend str 'design'
degraded bool False
degradation_reason str ''
agentic_evidence dict[str, Any] \| None None

Functions

normalize_completion_state(value: Any, default: CompletionState = 'qualified-draft') -> CompletionState

Map legacy persisted completion labels to the canonical reliability states.