Open source · CLI · Runs entirely on your machine
+Turn opportunities into approved, bounded experiments.
+Genesis is a local-first, human-governed engine for validating business ideas before you spend money on them.
+A Node.js CLI that gives founders and operators a disciplined, auditable workflow: capture evidence, preregister a bounded test, and put every approval on the record. No server. No account. Nothing leaves your machine.
+git clone https://github.com/zee-cpu/Genesis.git +cd Genesis +npm ci +node bin/genesis.mjs --help+
The governed path
+Six steps. One explicit approval. Zero inference.
+Genesis separates proposal, approval, and activation — so an experiment can only go live when a named human has approved that exact experiment, actor, and limit envelope.
+Discover
+Register the opportunity: target customer, problem, hypothesis, confidence — and evidence with source and provenance, contradicting included.
+Plan the experiment
+Preregister a bounded validation test: exact metric, expected effect, max cash, max labor hours, max duration, allowed data classes, risk level.
+Review
+Inspect the exact approval envelope — scope, actor, limits, effective time, expiry — before any human decision is made.
+Approve or deny
+An explicit named approver — genesis-owner — confirms scope, actor, limits, and expiry. Nothing is inferred or auto-approved.
Activate
+A separate manual command revalidates the approval and marks the experiment live — with the full authorization trail behind it.
+Revoke / supersede
+Authority can be withdrawn at any time. History is never deleted — only superseded, with every prior version preserved.
+Why Genesis
+Discipline you can audit. Privacy you don't have to trust.
+Local-first & offline
+No network calls at runtime. Your opportunities, evidence, and approvals never leave your machine.
+Human-governed by design
+No silent approval, no inferred authority. Every mutation shows a full proposal and requires an explicit y before anything is written.
Immutable audit trail
+Every decision, evidence item, experiment, and approval is append-only, schema-validated YAML. Corrections create new versions — nothing is overwritten.
+Evidence-driven
+Contradicting evidence is captured as data with source and provenance — not treated as failure. Beliefs change when reality does.
+Bounded experiments
+Every test preregisters its own ceiling — spending, labor hours, duration, data classes, and risk — before it can even be approved.
+Recoverable
+The local SQLite index is just a rebuildable cache. Canonical YAML is always the source of truth — genesis rebuild-index restores everything.
Command reference
+The whole engine fits in nine commands.
+genesis start-business
+ Register an opportunity + first evidence
+ genesis add-evidence <id>
+ Append supporting or contradicting evidence
+ genesis status <id>
+ Show lifecycle state, gates, and metrics
+ genesis plan-experiment <id>
+ Preregister a bounded experiment
+ genesis review-experiment <id>
+ Read-only view of the approval envelope
+ genesis approve-experiment <id>
+ Explicit Human Authority approval
+ genesis deny-experiment <id>
+ Explicit Human Authority denial
+ genesis start-experiment <id>
+ Manual, revalidated activation
+ genesis revoke-approval <id>
+ Revoke and supersede — no deletion
+ Get started
+Govern your next experiment.
+Clone the repository, register your first opportunity, and put every decision on the record — starting tonight.
+