Architecture Overview

What is wiiiv

Decision-integrity infrastructure that uses LLM
but is not governed by LLM.

wiiiv (pronounced "Weave") provides the structural guarantees that make LLM-driven decisions trustworthy, auditable, and safe to delegate to.

0
Unit Tests
0
Test Executions
0
Patents Filed
0
Canonical Specs
Not Another AI Tool
LLM capability is already sufficient. What's missing is trust. wiiiv builds trust through structure.

What wiiiv is not

AI Tool
Workflow Automation
LLM Orchestrator
Chatbot Framework

What wiiiv is

Decision-integrity infrastructure
Governed execution environment
Auditable judgment pipeline
Adversarial consensus system
Absolute Rule #1

FAIL-CLOSED

When uncertain, deny — never approve by default. If the LLM fails, the system does not silently pass the request through. It holds, denies, and escalates to a human.

Absolute Rule #2

Specification Above Code

Canonical specification documents sit above the codebase in authority. Code merely implements the contract. An implementation that violates the spec is not an extension — it is a design violation.

8-Layer Judgment Pipeline
Every decision flows through eight distinct layers, each with absolute responsibility boundaries. No layer may cross into another's domain.
01 Spec Judgment Asset

The raw material for judgment — not an instruction, but the full context that makes judgment possible. Spec must never be compressed or summarized. Thinning a Spec is damage to judgment capability. It is the richest asset in the system.

02 Governor Judgment Subject

The supreme normative document of the system — a constitution. The Governor is the sole judgment subject. It decides whether to proceed, what to ask DACS, how to interpret the consensus, and what to record. It has 7 absolute prohibitions.

⛔ FORBIDDEN: Direct execution, bypassing Gate, ignoring DACS consensus, accessing Executor internals
03 DACS Consensus Engine

Divergent Adversarial Consensus System. Three independent LLM personas — Architect, Reviewer, Adversary — evaluate every decision from opposing viewpoints. Uses VetoConsensusEngine: a single REJECT from any persona kills the entire decision. Patent filed.

04 Blueprint Judgment Snapshot

An immutable, per-request snapshot of the judgment process — like a Git commit for decisions. Contains the Spec snapshot, DACS result, Governor judgment, and execution plan. Once created, it cannot be modified. A Blueprint without a Spec is invalid.

Trust Boundary
05 Gate Enforcement

Cold and merciless policy enforcement. Gate chain: DACS Gate → User Approval → Permission → Cost. Any single DENY in the chain means total DENY. No admin bypass. No exceptions. No "just this once."

⛔ FORBIDDEN: Making judgments, interpreting context, exercising discretion
06 Executor Execution Only

Executes Blueprint steps without judgment — it doesn't ask why. Cannot access the original Spec. Cannot interpret results. Cannot control flow. LLM calls are permitted as execution mechanics, but result interpretation is absolutely forbidden.

⛔ FORBIDDEN: Accessing Spec, interpreting results, controlling flow, making judgment calls
07 Runner Orchestration

Orchestrates step execution with fail-fast policy and parallel group management. Aggregates results mechanically. Final status is determined by priority rules, never by semantic analysis. Runner is Governor's internal tool.

08 RetryPolicy Retry Rules

Mechanical retry rules based solely on ErrorCategory. Only IO_ERROR, TIMEOUT, and EXTERNAL_SERVICE_ERROR are retryable. Cancelled is never retried. "When in doubt, don't retry." Each attempt is recorded individually, never merged.

DACS — Divergent Adversarial
Consensus System
Three independent LLM personas evaluate every decision from deliberately opposing viewpoints. A single dissent kills the decision.
🏗️
Architect
Structural Feasibility

Evaluates whether the request is structurally sound and technically achievable.

APPROVE REJECT ABSTAIN
🔍
Reviewer
Requirements Compliance

Checks whether the request meets requirements, policies, and stated constraints.

APPROVE REJECT ABSTAIN
🛡️
Adversary
Risk & Security

Actively seeks attack vectors, abuse potential, and hidden risks in every request.

APPROVE REJECT ABSTAIN
▼ ▼ ▼

VetoConsensusEngine

1 REJECT from any persona → NO (Veto)
1 ABSTAIN from any persona → REVISION
ALL APPROVE unanimously → YES
📜 Patent Filed — Application #4 (DACS)
Open Standard
HLW — Human-Level Executable
Workflow Standard
A workflow language built on human cognition, not programming paradigms. Five node types derived from the minimal complete set of human thought.
👁️
Observe
Perceive the external world
⚙️
Transform
Interpret & process data
🔀
Decide
Choose the next path
Act
Affect the external world
🔁
Repeat
Apply across items

Node structure confines LLM non-determinism to individual nodes rather than the entire workflow. Without nodes, the LLM improvises everything — probabilistic variance spans the whole process. With nodes, variance is contained within each step while the structure remains fixed.

process77.hlw
{ "$schema" "https://hlw.dev/schema/hlw-v1.0.json" "version" "1.0" "name" "Unpaid Order Notification" "nodes" [ { "type" "observe" "description" "Fetch orders from the past 7 days" "target" "GET /api/orders?days=7" "output" "orders" } { "type" "transform" "hint" "filter" "description" "Extract UNPAID orders older than 3 days" "input" "orders" "output" "unpaidOrders" } { "type" "decide" "description" "If unpaid orders exist, notify; otherwise end" "branches" { "hasItems" "step4" "empty" "end" } } { "type" "repeat" "over" "unpaidOrders" "as" "order" "body" [{ "type" "act" "description" "Send payment reminder to customer" "target" "POST /api/notifications" }] } ] }
Human Readable LLM Executable Save & Re-run Judgment Nodes
LangGraph
n8n / Zapier
CrewAI / AutoGen
HLW (wiiiv)
FAIL-CLOSED Design
Most systems fail open — when something goes wrong, they approve by default to keep operations running. wiiiv takes the opposite approach.

⚠️ FAIL-OPEN (Typical)

Request arrives
LLM evaluates
💥 Failure occurs
Default: APPROVE

"We have to keep things running somehow."

🛡️ FAIL-CLOSED (wiiiv)

Request arrives
LLM evaluates
💥 Failure occurs
Default: DENY + Escalate

"If we're not sure, we don't approve."

Degraded Mode — Operating Without LLM

Even when the LLM is completely unavailable, the system continues to operate with policy-based decisions:

✔ Policy-based decisions
✔ Simple risk assessment
✔ Safe default rejection
✔ Full audit logging
✔ Human escalation
✔ Circuit breaker activation
✘ LLM persona evaluation
✘ Complex context analysis
Adversarial Attack Resistance
wiiiv defends against four classified attack vectors with dedicated countermeasures at every layer of the judgment pipeline.
VECTOR 01
Intent Concealment
"This is just for research purposes."
"I won't actually use this in production."
🛡️ Intent Drift Detection — separates surface intent from actual impact. The stated purpose is analyzed independently from the real-world consequences.
VECTOR 02
Authority Abuse
"I'm the admin."
"The CEO authorized this."
"I'll take responsibility."
🛡️ Authority Neutralizer — role does not equal privilege over safety. No organizational authority can override safety constraints.
VECTOR 03
Progressive Risk
Step 1: "Classify users" (harmless)
Step 2: "Analyze patterns" (ambiguous)
Step 3: "Target that group" (dangerous)
🛡️ Context Accumulator + Hard Stop — cumulative risk scoring across the session. Hard stop when threshold is breached.
VECTOR 04
Responsibility Diffusion
"The AI decided this, not me."
"It's an automated system, so it's not my fault."
🛡️ Responsibility Lock — AI is not a legal liability subject. Responsibility is structurally locked to the adopting organization.
Audit & Integrity Guarantees
Every judgment is recorded in an immutable hash chain. Tampering is structurally impossible — any modification breaks the chain and triggers immediate detection.
Decision 1
a1b2c3
Chain: a1b2c3
Decision 2
d4e5f6
Chain: H(a1b2c3+d4e5f6)
Decision 3
g7h8i9
Chain: H(prev+g7h8i9)
Verified
✔ Intact
No tampering detected
Responsibility Attribution
LEVEL 1
wiiiv System
Request analysis, risk identification, consensus, judgment recording
✘ No legal liability (AI cannot be a legal subject)
LEVEL 2
System Administrator
Policy configuration, persona setup, consensus rules
△ Operational responsibility
LEVEL 3
Organization
System adoption, policy approval, legal accountability
✔ Full legal responsibility — the adopting organization bears all accountability
4 Patents Filed
Core architectural innovations have been formally filed as patent applications.
PATENT #1
Crystallization
A system and method for converting conversational AI sessions into deterministic, replayable workflows. Transforms ephemeral LLM interactions into persistent, versioned execution artifacts.
Filed: 대화형 AI 세션을 결정론적 워크플로우로 변환하는 시스템 및 방법
PATENT #2
Recovery Layer
Deterministic error recovery for LLM-generated workflows without requiring additional LLM calls. Code-based repair that eliminates the cost and latency of re-invoking the model on failure.
Filed: LLM 생성 워크플로우의 결정론적 오류 복구 시스템
PATENT #3
Knowledge Selector
Reference-scale adaptive LLM selection and context optimization. Automatically tiers document loading based on corpus size — from full injection for small sets to LLM-driven selection for medium, and on-demand browsing for enterprise scale.
Filed: 참조 문서 규모 적응형 LLM 선택 및 컨텍스트 최적화
PATENT #4
DACS
Multi-persona veto consensus system. Independent adversarial evaluation by structurally opposed LLM personas with a veto-based consensus engine where a single REJECT overrides all approvals.
Filed: 다중 페르소나 거부권 합의 시스템 (DACS)
12 Canonical Specifications
Every architectural layer is governed by a formal specification document. Code implements these contracts — never the reverse. "Specification is above code."
01
Spec Definition v1.0
Defines "Spec" as the raw judgment material — the richest asset in the system. Compression or summarization is explicitly forbidden.
229 lines
02
Governor Role Definition v1.1
The supreme normative document — the system's constitution. Governor is the sole judgment subject with 7 absolute prohibitions.
398 lines
03
DACS Interface v2.1
3 independent LLM personas with VetoConsensusEngine. Provides only YES / NO / REVISION signals. Governor↔DACS boundary formally defined.
446 lines
04
Gate Spec v1.0
The sole enforcement subject — cold and merciless. 4 canonical Gate types in ordered chain. Any DENY = total DENY. No admin bypass.
293 lines
05
Blueprint Spec v1.1
Immutable per-request judgment snapshot, like a Git commit for decisions. Blueprint without Spec is invalid.
403 lines
06
Blueprint Structure Schema v1.0
Complete JSON schema with immutability markers. Gate Input Boundary table defines exactly which fields each Gate type can inspect.
445 lines
07
Blueprint Node Type Spec v1.0
5 canonical node types with action→permission mappings. Gate sees only action, never params. Full multi-step Blueprint example.
488 lines
08
Executor Definition v1.0
Executes without judgment. Cannot access Spec, cannot interpret results, cannot control flow. 4 categories of prohibited actions.
365 lines
09
Executor Interface Spec v1.0
Complete Kotlin interface definitions — sealed class hierarchies, 7 ErrorCategories, 5 CancelSources, TraceCollector protocol.
817 lines
10
ExecutionRunner Spec v1.0
Orchestrates step execution but never judges. Parallel execution with fail-fast policy. Final status is mechanical aggregation only.
346 lines
11
RetryPolicy Spec v1.0
Mechanical retry based solely on ErrorCategory. Only IO_ERROR, TIMEOUT, EXTERNAL_SERVICE_ERROR are retryable. "When in doubt, don't retry."
266 lines
12
Prompt Specification v1.0
All 8 LLM prompts treated as formal contracts. 51 invariants across 3 tiers (S-class, B-class, E-class). Guardrail Escalation Protocol for when prompts fail.
492 lines
4,988 lines of formal specification — every line is a contract that code must honor.
By the Numbers
wiiiv is not a whitepaper or a concept. It is a running system backed by extensive automated verification.
0
Unit Tests
0
Test Executions
0
Verification Scenarios
0
Architecture Layers
0
HLW Node Types