/dna

One program for building, running, governing and recording an application.

Code is now written faster than anyone can read it. DNA gives a Hale application what a company gives a product: people with final say, which DNA calls the Board; a reviewer with limited authority, an AI-backed role called the Leader; a delivery pipeline that proposes, proves and applies each change; the machines that run it and the monitoring that watches it; the models it may call and the budget it may spend; and an audit log of every decision. Those are usually four systems and a wiki. Here they are one program next to your code, with its working state in a database it owns and its history as commits in your repository.

What hale dna init writes

hale dna init generates the organism next to your code and leaves the application untouched. What it writes is the organization as source: a purpose and a charter, the Board and the Leader and the grant between them, the models and the daily budget, the work it accepts and the workflows that carry it, and a law the compiler holds against the wiring you actually built. It also writes what the organism runs on and what watches it. One program carries the whole loop from then on. You ask for something in a sentence, from a terminal, another clone, GitHub, or the page it serves. The substrate copies the repository, lets a model edit under a grant that is read, edit, format and check and nothing more, and commits the candidate there. The toolchain then checks, verifies and tests it, composes the fleet it would deploy, diffs it against the program's structure, rehearses rolling it back, and keeps every output under its own hash.

One review, three views, pinned to one commit: the source diff, the structural diff, the evidence. The Leader decides inside the grant, a model reading those views and leaving its reasoning on the record. The Board decides outside the grant, or when the law, an effect or the fleet's shape moves, and the Board is people. Approval is a commit. It is expressed, restarted here or redeployed by every node the plan assigns, and watched. An instance that falls over inside the observation window rolls the change back everywhere, and the record names the instance.

The working state lives in a database the organism owns, under its own roles; the nerves are a stream; the vault holds its secrets. The history is refs/dna/journal: one commit per event, in the repository the code lives in, so a teammate with a clone has the whole story and a pull request can be the review. The organism grows the way the code does. A new responsibility, a practice or a wider grant is a proposal, a candidate commit, a verdict and a restart, so the record is the organization.

What one organism holds

One session

The demo application, with the editor on scripted models so the transcript is reproducible. A hosted model gives the same commands and the same record.

terminalhale dna
$ hale dna init .            # the organization, generated next to your code; the app untouched
$ hale dna dev               # the organization and the application on this machine
$ hale dna ask document the chat server in main.hl
task t1 born for intent i1a08c0786c5 [pending]

$ hale dna review m1
review m1 [pending]: apply m1 (docs): document the chat server in main.hl?
  needs leader · candidate bf94e503c1c002f277248b14b6afd1910bb8ce6f

source diff (git 232dc8f18dde .. bf94e503c1c0):
  +// documented by the organism: Echo answers every Ping

semantic diff (hale model diff, baseline .. candidate):
  classification: source-only  ·  no semantic differences

evidence (fmt=0 check=0 verify=0 test=0 diff=0 rollback=0 fleet=0):
  check      yes    0 e3b0c44298fc
  test       yes    0 184a3407ce31
  fleet      yes    0 b33b2e832b21
  rollback   yes    0 89978376be81

$ hale dna review m1 approve --as riley --comment "fine"
review m1 settled: approve by riley
hale dna dev: expression restarted (pid 1875137) as 3c9b9327e480d349 build 7a489ad3e72c
hale dna dev: m1 observed healthy for 5s as 3c9b9327e480d349

That is the daily surface: ask, review, status, history, board. A team sets git config dna.github, which turns every pending review into a pull request and every GitHub review into a verdict. A fleet adds a plan that names each service's seed and node; hale node runs a node, and an approval redeploys the instances it touched. The rest is how much the Leader may decide and which models it uses: a grant and a router in a file you own.

Why, in 2026

The habitat in development

An organism looks after one application and its record. People rarely work inside just one. The same person answers to a team, a company and a customer, and firms cooperate on shared work without sharing their books. The habitat is the layer for that: the records, tools, channels and practices that several organisms and the people in them share, and the rules for sharing them. One effort's organism can be the habitat of several others, and the relationships between them need not form a tree. It never requires incorporation, control of an employer's systems, or a new accounting platform.

What exists today

piece of the designin the tree today
A record per repository, never rewoundYes. Memory and the record.
Deliberate publication between recordsConnections and handoffs of single facts with origin, lineage and purpose: hale dna connect, hale dna handoff.
Protected evidence outside the replicated recordReceipts filed as customer or confidential are kept in memory alone, and every read is a row: hale dna receipt.
Deployment profileshale dna new --profile local | remote-body, hale dna profile.
A verified principal sourceAn OIDC-signed head: git config dna.principal oidc.
Roles per client on each backendMemory's roles, one broker account per role and per attached application, and vault slots.
Money reserved against grantsSpend reserved, settled and compensated under a grant's windows.
runs_under, policies as projections, per-attachment credentialsNot built. Reserved as a relation for the compiler's registry.
Standard equipmentNot built.
Finance capture and booksNot built. No automated payment is part of the first slice.

Nothing in the design is behaviour to rely on today unless the table says so. The habitat, as designed →

What it needs, and what it does not claim

Start

hale dna init . && hale dna dev

The organism section of the guide reads the organism first: the map of its parts, getting started, one task end to end, then one chapter per part, and shaping and governing it. The building block underneath, with the record as a git branch, the review's pin and the autonomy rules, is DNA, the building block. The design it implements is Hale DNA, Phase 3, on the RFC.