"Visual clarity enables governance transparency."
— WINDI Documentation Principle
Diagram 1
Three Dragons Protocol
The coordination model for AI-assisted governance with distinct roles and responsibilities.
flowchart TB
subgraph HUMAN["Human Authority"]
HV["Human Volante
(Decision Maker)"] end subgraph DRAGONS["Three Dragons"] G["🐉 Guardian
Governance & Priority"] A["🐉 Architect
Structure & Design"] W["🐉 Witness
Validation & Audit"] end HV -->|"Commands"| DRAGONS G -->|"Advises"| HV A -->|"Proposes"| HV W -->|"Validates"| HV G <-->|"Coordinates"| A A <-->|"Reviews"| W W <-->|"Confirms"| G
(Decision Maker)"] end subgraph DRAGONS["Three Dragons"] G["🐉 Guardian
Governance & Priority"] A["🐉 Architect
Structure & Design"] W["🐉 Witness
Validation & Audit"] end HV -->|"Commands"| DRAGONS G -->|"Advises"| HV A -->|"Proposes"| HV W -->|"Validates"| HV G <-->|"Coordinates"| A A <-->|"Reviews"| W W <-->|"Confirms"| G
Diagram 2
Human-in-the-Loop Workflow
Every system operation requires human initiation, review, and approval.
sequenceDiagram
participant H as Human Operator
participant S as WINDI System
participant V as Validation Gate
participant O as Output
H->>S: 1. Initiate Task
S->>S: 2. Process Request
S->>H: 3. Present Draft
H->>H: 4. Review & Evaluate
alt Approved
H->>V: 5a. Approve
V->>O: 6. Release
else Revision Needed
H->>S: 5b. Request Changes
S->>H: Return to Step 3
else Rejected
H->>H: 5c. Discard
end
Note over H,O: Human approval required at every step
Diagram 3
System Architecture
Three-layer separation ensuring governance, processing, and infrastructure integrity.
flowchart TB
subgraph INTERACTION["Interaction Layer"]
UI["A4 Desk BABEL"]
CHAT["Chat Interface"]
EDITOR["Document Editor"]
end
subgraph PROCESSING["Processing Layer"]
CORE["WINDI Core"]
VALID["Constitutional Validator"]
AGENT["WINDI Agent"]
end
subgraph INFRA["Infrastructure Layer"]
DB["Database"]
LEDGER["Governance Ledger"]
BACKUP["Backup System"]
end
INTERACTION --> PROCESSING
PROCESSING --> INFRA
VALID -->|"Compliance Check"| CORE
LEDGER -->|"Audit Trail"| VALID
Diagram 4
The Eight Invariantes
Constitutional principles that cannot be violated under any circumstances.
mindmap
root((INVARIANTES))
Soberania
Human authority
AI serves only
Non-Opacity
Visible processes
No hidden operations
Transparência
Audit trails
Documented reasoning
Jurisdição
Defined scope
Clear boundaries
No Fabrication
Verified facts only
No invention
Conflict Structuring
Explicit handling
Documented resolution
Institutional
Formal standards
Professional conduct
No Depth Punishment
Consistent behavior
Fair treatment
Diagram 5
Escalation Model
When uncertainty arises, institutional caution takes precedence over speed.
flowchart TD
ISSUE["⚠️ Issue Detected"]
ISSUE --> PAUSE["Operator: PAUSE"]
PAUSE --> ESCALATE["Escalate to Guardian"]
ESCALATE --> ASSESS{"Assessment"}
ASSESS -->|"Technical"| ARCHITECT["Architect Review"]
ASSESS -->|"Governance"| GUARDIAN["Guardian Decision"]
ASSESS -->|"Operational"| OPERATOR["Operator Adjustment"]
ARCHITECT --> RESOLVE["✓ Resolution"]
GUARDIAN --> RESOLVE
OPERATOR --> RESOLVE
RESOLVE --> RESUME["Resume Operations"]
Diagram 6
Document Lifecycle
From creation to verified institutional output.
flowchart LR
CREATE["Create"] --> EDIT["Edit"]
EDIT --> REVIEW["Human Review"]
REVIEW --> APPROVE{"Approved?"}
APPROVE -->|"Yes"| SIGN["Generate Receipt"]
APPROVE -->|"No"| EDIT
SIGN --> EXPORT["Export PDF"]
EXPORT --> VERIFY["QR Verification"]
VERIFY --> ARCHIVE["Governance Ledger"]