SPEC_VER // 2026.1 (RETRO-FUTURIST INDUSTRIAL SPEC) ARCHITECTURE: DETERMINISTIC CONTROL & BOUNDED AUTHORITY

// unified autonomous engineering ecosystem / deterministic authority

Howl Ecosystem

Engineered by William Elias, Howl is an integrated open-source software ecosystem engineered to bring mathematical rigor, capability boundaries, adversarial verification, and cryptographic human authority to AI-assisted software engineering.

AXIOM // INTENT IS NOT AUTHORITY. Probabilistic intelligence proposes changes; deterministic machinery strictly verifies constraints; human operators retain sovereign authority over consequential risk.
LIFECYCLE // IMAGINE → ORCHESTRATE → BUILD → CHALLENGE → GOVERN → LEARN ↺ 11 NODES // 6 LIFECYCLE, 5 SUPPORTING
01 // HOWLCREATE
Creative Search
Computational creativity, assumption inversion, and concept lineage.
[TIER 0 // IDEATION]
02 // HOWLDREAM
Controlled Divergence
Speculative generation, induced failure, and scoped verification against evidence.
[TIER 2 // EXPERIMENTAL]
03 // HOWLPLANE
Control Plane
Multi-agent orchestrator, deterministic task router, and evidence ledger.
[TIER 1 // ORCHESTRATION]
04 // HOWLFRAME
Reasoning & VM
AI DSL compiler, typed HFIR verification gate, and capability-bounded VM.
[TIER 0 // COMPILER]
05 // HOWLPROOF
Red-Team QA
Adversarial evaluation, reproducible findings, and evidence a verdict can rest on.
[TIER 2 // VERIFICATION]
06 // HOWLCHANGEOPS
Release Authority
Cryptographic HMAC human gates, TOCTOU defense, and bounded Git actions.
[TIER 1 // GOVERNANCE]
07 // HOWLRELAY
Persistence & Relay
Persistent asynchronous work coordination, durable journals, and handoffs.
[TIER 1 // CONTINUITY]
08 // HOWLBOARD
Evaluation Surface
Live telemetry console and full-stack deterministic state machine board.
[TIER 2 // TELEMETRY]
09 // HOWLWRITER
Writing & Review
Voice preservation, deterministic style linting, humanization, and review.
[TIER 2 // PROSE]
10 // HOWLNOTES
Field Notebook
Knowledge repository and external consumer proving native file persistence.
[TIER 2 // KNOWLEDGE]

SECTION // 01 Overview & Architectural Thesis

ECO-MOD-OVERVIEW

Modern AI coding assistants excel at pattern matching, generating diffs, and synthesizing code. However, when granted unconstrained access to tools, file systems, and production environments, they introduce severe risks: hallucinated dependencies, prompt injection vulnerabilities, breaking architectural drift, and unauthorized mutations.

The Howl Ecosystem solves this structural flaw through architectural separation. In Howl, AI models operate inside bounded reasoning tiers that generate verifiable intermediate representations. Execution authority belongs strictly to deterministic compilers, sandboxed runtimes, and cryptographically signed human approval gates.

SECTION // 02 Ecosystem Interoperability Topology

ECO-MOD-TOPOLOGY
[SCHEMATIC // BUILD → CHALLENGE → GOVERN → LEARN] HOWL_TOPOLOGY
                    ┌────────────────────────┐   ┌────────────────────────┐
                    │  HOWLCREATE (IDEATE)   │   │  HOWLDREAM (EXPLORE)   │
                    │ Concepts & Lineage     │   │ Divergence & Failure   │
                    └───────────┬────────────┘   └───────────┬────────────┘
                                └──────────┬─────────────────┘
                                           ▼  candidate work
                              ┌────────────────────────┐
   ┌─────────────────────────►│  HOWLPLANE (CONTROL)   │◄──────────────────┐
   │                          │ Routing, Review, Gates │                   │
   │                          └───────────┬────────────┘                   │
   │  remediation routed                  │ builds                         │
   │  to the right builder                ▼                                │
   │                          ┌────────────────────────┐                   │
   │                          │  HOWLFRAME (BUILD)     │                   │
   │                          │ Typed HFIR & Bounded VM│                   │
   │                          └───────────┬────────────┘                   │
   │                                      │ artifact                       │
   │                                      ▼                                │
   │                          ┌────────────────────────┐                   │
   └──────────────────────────┤  HOWLPROOF (CHALLENGE) │                   │
       findings + evidence    │ Falsify. Reproduce.    │                   │
       (never repairs)        │ Verdict.               │                   │
                              └───────────┬────────────┘                   │
                                          │ ADVISORY verdict               │
                                          ▼                                │
                              ┌────────────────────────┐                   │
                              │ HOWLCHANGEOPS (GOVERN) │                   │
                              │ Approval & Rollback    │                   │
                              └───────────┬────────────┘                   │
                                          │ released                       │
                                          ▼                                │
   ┌──────────────────────┬───────────────┴──────┬──────────────────┐      │
   ▼                      ▼                      ▼                  ▼      │
┌────────────────┐┌────────────────┐┌────────────────┐┌────────────────┐   │
│HOWLRELAY       ││HOWLBOARD       ││HOWLWRITER      ││HOWLNOTES       │   │
│Continuity      ││Evidence Surface││Prose & Review  ││Knowledge       │   │
└────────────────┘└───────┬────────┘└────────────────┘└────────────────┘   │
                          └──────────────────────────────────────────────► ┘
                                        what was learned re-enters control

SECTION // 02B Engineering Questions & Architecture Answers

ECO-MOD-QA

How do AI coding agents safely make changes without unrestricted permissions?

Direct Answer: By strictly decoupling probabilistic code generation from deterministic execution authority. In the Howl ecosystem, coding agents generate proposals inside bounded sandbox tiers (HowlFrame), but have zero ambient authority to execute shell commands, mutate files, or deploy artifacts. Consequential mutations must pass through capability-checked boundary gates (HowlChangeOps) that verify pre-conditions, enforce automated test gates, and require explicit cryptographic human sign-off before committing state changes.

How do long-running AI engineering agents operate continuously across sessions?

Direct Answer: Through durable state journals, structured handoffs, and deterministic supervisory control. Rather than relying on transient LLM context windows that degrade or collapse over time, the Howl control plane (HowlPlane) coordinates work dispatch, timeout governance, and failover across provider pools. Persistent session coordination and structured handoff state are managed by HowlRelay, persisting immutable trajectory journals and context packages so subsequent agent sessions resume exactly where previous sessions concluded.

What is an autonomous AI engineering ecosystem?

Direct Answer: A coordinated multi-tier platform where specialized autonomous agents perform distinct engineering lifecycle functions—ideation, compilation, orchestration, verification, continuity, and documentation—under strict deterministic invariants. Rather than an unconstrained "all-in-one" bot, each subsystem owns a distinct domain: HowlCreate explores candidate approaches, HowlPlane directs execution and adversarial verification, HowlFrame provides the capability runtime, and HowlChangeOps guards the production release boundary.

SECTION // 03 Ecosystem Project Directory

ECO-MOD-DIRECTORY

Each repository in the Howl ecosystem fulfills a dedicated, non-overlapping role:

HowlCreate TIER 0 // IDEATION

Computational creativity, open-ended problem exploration, reframing, and concept lineage. Features lateral exploration operators, epistemic assumption challenging, and structured lineage trees for complex problem discovery.

HowlFrame TIER 0 // VM

The core intelligence and reasoning framework. Features an AI-native Lisp-like DSL, typed HFIR intermediate representation, capability-checked execution boundaries, and standalone bytecode VM.

HowlPlane TIER 1 // CONTROL

The autonomous AI engineering control plane. Houses deterministic multi-agent task routing, independent falsification reviewers, evidence ledgers, and human sign-off gates.

HowlChangeOps TIER 1 // AUTHORITY

Policy-driven Git change and release controller. Binds AI intent to cryptographically signed human approval envelopes, defending against TOCTOU drift and unauthorized mutations.

HowlRelay TIER 1 // CONTINUITY

Persistent asynchronous work coordination, durable journals, and resumable execution handoffs. Manages durable append-only work journals, verified handoffs, session resumption, and anti-surveillance work-system telemetry.

HowlNotes TIER 2 // KNOWLEDGE

A complete notes application built as an external dogfood consumer of HowlFrame, proving browser compilation from (web_app) and durable native record store persistence.

HowlBoard TIER 2 // TELEMETRY

The flagship full-stack evaluation surface and deterministic task state machine. Continuously surfaces compiler friction and verifies state transition invariant policies.

HowlWriter TIER 2 // PROSE

Writing control system combining deterministic style linting, authentic author voice preservation, claim provenance, and HowlPlane-controlled independent model review.

HowlProof TIER 2 // VERIFICATION

Independent red-team QA. Challenges an artifact, tries to falsify it, and issues a verdict backed by a reproducible evidence bundle. It never repairs what it judges. Experimental, milestone one.

HowlDream TIER 2 // EXPERIMENTAL

Experimental controlled divergence, hallucination experiments, baseline comparisons, and scoped verification. Dream output is data, not authority.

SECTION // 04 Governing Principles & Axioms

ECO-MOD-PHILOSOPHY

01 // Intent Is Not Authority

An AI model's output represents an unverified proposition. It can never grant itself permission or execute consequential state changes without cryptographic sign-off.

02 // Fail-Closed Capability Gates

Every runtime operation (network sockets, disk writes, subcommands) requires an explicit capability token. If omitted or corrupted, execution terminates immediately.

03 // Adversarial Verification

Code changes are never accepted on builder claims alone. Independent falsifiers continuously probe edge cases, invariant rules, and state drift.

04 // Epistemic Humility

When live environmental evidence conflicts with static assumptions or specifications, live evidence takes precedence, triggering audit reconciliation.

SECTION // 05 Visual System & Design Tokens

ECO-MOD-DESIGN

All Howl projects share a unified design system inspired by the retro-futurist industrial aesthetic of 2026 Science SARU / Ghost in the Shell:

Token Hex Value Semantic Role in Howl
--howl-shell #E7E1CE Warm paper/field notebook surface (Default light background)
--howl-near-black #14191C Terminal foundation (Default dark background)
--howl-navy #102A43 Structural header bands, frames, and infrastructure panels
--howl-cyan #28B7D8 Information links, verified telemetry, and test evidence
--howl-blue #087FAF Primary interactive actions and orchestration routes
--howl-red #D94732 Authority gates, fail-closed boundaries, and destructive mutations
--howl-magenta #E21D68 Restrained AI reasoning and probabilistic intent markers
--howl-amber #F2A91B Pending review states, warning thresholds, and human authority
--howl-khaki #827C68 Experimental companions and speculative, unverified material

SECTION // 06 Quick Start & Howl CLI

ECO-MOD-SETUP

The howl CLI is the canonical entry point for inspecting, diagnosing, and coordinating the Howl ecosystem.

[BASH // HOWL_CLI_SETUP]
# Clone and build the Howl ecosystem CLI:
git clone https://github.com/howlcipher/howl.git
cd howl && go build -o bin/howl ./cmd/howl

# Check the environment and what is installed:
./bin/howl doctor
./bin/howl status

# Install, update and roll back managed components:
./bin/howl install howlframe
./bin/howl update
./bin/howl rollback howlframe

# Switch release channel, or remove a component:
./bin/howl channel stable
./bin/howl uninstall howlframe