DocsCore ConceptsValidation Matrix

Validation Matrix

How HelixMind validates AI output with a 3-phase pipeline. classify, work, validate. before applying changes.

Validation Matrix

Requires Login (Free+): The Validation Matrix requires a free HelixMind account. Run helixmind login to unlock. it's free, no credit card needed. In Open Source mode, validation is disabled.

The Validation Matrix is a 3-phase pipeline that checks every AI output before it's applied to your codebase.

The 3 Phases

Phase 1: Classify

Each task is classified before validation:

CategoryExamples
ui_componentFrontend components, layouts
api_endpointAPI routes, handlers
data_processingData transformation, ETL
refactoringCode restructuring
bug_fixBug fixes, patches
configurationConfig files, settings
documentationDocs, comments
testingTest files, assertions
architectureStructural changes
general_codeEverything else
chat_onlyConversational (skips validation)

Complexity: trivial โ†’ simple โ†’ medium โ†’ complex. determines check strictness.

Phase 2: Work

The AI produces its output (code edits, new files, commands).

Phase 3: Validate

Three parallel check systems:

Check TypeHow It Works
Static (15+)Algorithmic: HTML validation, SQL injection detection, import validation, secret detection, type safety, unused variables, anti-patterns
DynamicA smaller LLM reviews for logical issues static analysis can't catch
SpiralKnowledge-based: style patterns, known bugs, project conventions

Dynamic model mapping:

Main ModelValidation Model
claude-opus-4-6claude-haiku-4-5
gpt-4ogpt-4o-mini
Ollama (local)Same model

Autofix Loop

When checks fail โ†’ AI generates fixes โ†’ re-validate โ†’ repeat up to 3 times.

Validation Report

โ•ญโ”€โ”€โ”€ โœ… Validation Matrix โ”€โ”€ 12 checks โ”€โ”€ 1 loop โ”€โ”€ 340ms โ”€โ”€โ”€โ•ฎ
โ”‚   Structural  : โœ…โœ…โœ…  3/3                                  โ”‚
โ”‚   Completeness: โœ…โœ…    2/2                                  โ”‚
โ”‚   Consistency : โœ…โœ…โœ…  3/3                                  โ”‚
โ”‚   Security    : โœ…โœ…    2/2                                  โ”‚
โ”‚   Style       : โœ…โœ…    2/2                                  โ”‚
โ”‚   12/12 passed โ”‚ 0 warnings โ”‚ 0 errors                      โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

CLI Control

Flag / CommandEffect
--no-validationDisable validation entirely
--validation-verboseShow detailed check results
--validation-strictTreat warnings as errors
/validationShow current status
/validation on/offEnable/disable
/validation verboseToggle verbose output
/validation strictToggle strict mode
/validation statsHistorical statistics
HelixMind โ€” AI Coding CLI with Spiral Memory