Cairn Documentation

Lenses 12

Each lens provides a different engineering perspective on the selected node.

Overview

Node header, description, children grid, health metrics, budget bars, and requirements summary at a glance.

Brief

AI-generated narrative documentation with 8 sections covering purpose, capabilities, operating modes, architecture, interfaces, constraints, verification, and risks.

Visuals

2D concept renders via Gemini image generation with style kits (technical, photorealistic, schematic), plus 3D mesh assets via MeshBuilder and Three.js.

Requirements

Functional, performance, interface, safety, environmental, and constraint requirements scoped to the selected node. Inline editing and AI generation via ⌘K.

Architecture

Interactive node graph showing child subsystems, interfaces, and data flow. Powered by @xyflow/react with drag layout, hover inspection, and interface port indicators.

Causality

Pyramid of Causality (Harney framework) — layers of prerequisite technologies from knowledge foundation through domain technologies to the capstone. Color-coded by maturity, with gap detection.

Completeness

Three-axis fidelity radar (entity, process, relationship coverage) per node with tree-wide heatmap. Flags gaps with one-click AI fix prompts. Based on Pace/Loper simulation fidelity dimensions.

Narrative

Systemigram visualization (McDermott/Boardman methodology) — AI identifies the mainstay transformation chain, generates verb phrases for connections, and renders a readable narrative diagram with pan/zoom.

Dendritic

Pruned alternatives tree showing active and rejected design paths. Each pruned node carries engineering prune reasons, first principles, and cross-branch dependencies. Detail panel with full evaluation history.

Behavior

State machines with states, transitions, guards, and actions. Visual state diagram scoped to the selected node. AI generation of operating modes via ⌘K.

Verification

Test, analysis, demonstration, and inspection records linked to requirements. Coverage tracking with pass/fail/blocked status.

Operational

Use cases and operational scenarios with actors, preconditions, postconditions, and step sequences. Scoped to system or subsystem level.