DNA by Humaan

DNA

Git remembers your code. DNA remembers your system.

Open-source project brain for TypeScript squads — plain-language features, quality gates, GitHub push, runtime Lab, and a 1045-pack marketplace. AI commits and PRs are tagged per project ([Acme], [DNA], …).

cd /path/to/your-project    # or portfolio parent for multi-app squads
npx @superhumaan/dna-by-humaan doctor

Website	dna.humaan.app
Marketplace	Marketplace · Bundles
Intelligence	dna.humaan.app/intelligence
Health	dna.humaan.app/health
npm	@superhumaan/dna-by-humaan
Supply chain	Socket.dev · SECURITY.md

Built by Humaan · Superlite

Latest (v0.6.24): Sharper npm/GitHub listing · project git naming (v0.6.23) · Skeletor fleet in AI context by default.

Team rollouts: TEAM-TESTING.md · Portfolio: docs/product/portfolio-install.md · Docs: docs/ · Changelog: CHANGELOG.md

---

What DNA is

DNA is not a documentation generator. It is:

• A project intelligence system — structured context AI can actually use
• An AI behaviour layer — rules that govern how Cursor, Copilot, and Claude work on your project
• A runtime issue detector — classifies errors with project-specific context
• A GitHub automation engine — contextual issues and repair PRs with project-tagged titles
• A knowledge marketplace — 1045 stack, compliance, and industry packs plus 27 purpose bundles
• A software immune system — severity, category, and discipline classification
• A memory layer — CellularMemory that learns from your project's history

---

Quick start

cd /path/to/your-project    # or portfolio parent for multi-app squads
npx @superhumaan/dna-by-humaan doctor

# In Cursor: type / for 103 stems and /dna-* commands — already installed
# Portfolio squads: run doctor on the parent folder, not each repo

---

Install

Method	Command
npm (recommended)	npx @superhumaan/dna-by-humaan doctor
Interactive wizard	npx @superhumaan/dna-by-humaan init -y then doctor
Team setup (monorepo dev)	git clone https://github.com/superhumaan/DNA.git && ./scripts/team-setup.sh
Manual	pnpm install && pnpm build && pnpm dna:link

Requirements: Node.js 20+, pnpm 9+

---

Portfolio install (one squad, many products)

Most squads cannot afford Sentry on every service, premium AI memory on every seat, and GitHub Teams on top of rent. Install DNA once on the folder that holds all related products — enterprise health apps, monorepo apps/*, agency client suites — not inside each repo.

cd ~/work/your-squad-folder     # parent of every related product
npx @superhumaan/dna-by-humaan doctor

One command installs everything — no bolt-ons, no “upgrade for memory”:

Layer	Included
Intelligence	.DNA/ — config, neuralNetwork, 8 behaviour files, 7 CellularMemory regions, immune system
AI workbench	AGENTS.md, Cursor + Claude rules/skills, always-on co-pilot (no “use DNA”)
Stems & commands	103 prompt stem packs (guidelines, expectations, workflows) + /dna-* slash commands
Feature factory	9-role agent loop, ai/agent-loop.md, product-process rules, quality gates
Detection	Stack, monorepo apps, AI tools, GitHub, healthcare/legal domain, Impressions drift, auth patterns
Runtime	Observer auto-wired into Express/Fastify/Next.js → classified issues + repair plans
Delivery	CI workflows, pre-push hook, Docker scaffold, GitHub browser login
Knowledge	Foundation packs from scan + 1045 marketplace packs + 27 purpose bundles (offline fallback)

One .DNA/ at the parent remembers every product and how they interconnect — feature #5 uses the same template as feature #1; runtime errors explain why across the suite.

Full manifest — why no one regrets this install →

---

Core commands

Command	What it does
dna init	Scaffold .DNA/ + DNA/Impressions/
dna analyze	Deep brownfield analysis (structure, auth, IVF gaps)
dna document --from-code	Reverse-engineer Impressions from existing code
dna plan ivf	Integrating Vertical Functions plan — before/after, phased migration
dna scan	Detect stack, tests, CI, risks
dna context cursor	AI-ready context for your tool
dna plan rbac	RBAC plan from plain language → permission matrix
dna platform list	DNA production feature catalog
dna plan feature <id>	End-to-end feature plan — Azure, SSO, admin, flags, CRM, CMS
dna plan compliance	Tiered ISO/GDPR/HIPAA/SOC 2 plan by org size
dna compliance list	Startup → enterprise compliance catalog
dna context compliance	Load tiered compliance knowledge for AI
dna validate	Check against Behaviour rules
dna doctor	Full health check
dna feedback report	Report a DNA-platform issue upstream (sanitized, opt-in)
dna feedback sync	Flush offline feedback queue
dna marketplace install <id>	Install knowledge packs
dna runtime install	Runtime integration snippets

Complete CLI reference →

---

Architecture

DNA maintains two separate worlds:

your-project/
├── .DNA/                 # AI-first intelligence (machines)
│   ├── config.dna.json
│   ├── neuralNetwork.json
│   ├── behaviour/
│   ├── knowledge/
│   ├── CellularMemory/
│   ├── immuneSystem/
│   └── runtime/
└── DNA/Impressions/      # Human documentation (people)
    ├── product/
    ├── architecture/
    ├── security/
    └── ...

.DNA/	DNA/Impressions/
Behaviour, memory, routing	Product, architecture, compliance docs
Runtime events and issues	SRS, release notes, user guides
AI tool configuration	Auditor and stakeholder facing

Learn the concepts →

---

Runtime observer

DNA ships as one package. The CLI runs in your terminal; the runtime imports from a subpath in your server:

pnpm add @superhumaan/dna-by-humaan

import { dnaRuntime } from "@superhumaan/dna-by-humaan/runtime";

dnaRuntime.start({ projectId: "my-app", projectRoot: process.cwd() });
app.use(dnaRuntime.express());
app.use(dnaRuntime.errorHandler());

Supports Express, Fastify, NestJS, and Next.js.

Runtime guide →

---

Knowledge marketplace

dna marketplace list
dna marketplace install frameworks/nextjs
dna marketplace install compliance/gdpr
dna marketplace install combo/nextjs-fullstack
dna update

Remote: dna.humaan.app/marketplace · Bundles · Offline bundled fallback included.

Marketplace docs →

---

GitHub, upstream feedback & AI repair

dna github login
dna github connect --owner ORG --repo REPO

# Upstream DNA platform feedback (opt-in, dna-only by default)
dna feedback report --message "doctor failed" --command "dna doctor" --dry-run
dna feedback sync
dna feedback status

dna ai connect --provider mock
dna ai repair --file issue.json --dry-run

Local issues: high/critical runtime errors → your project's GitHub repo.
Upstream feedback: DNA CLI/doctor/runtime failures → sanitized reports to superhumaan/DNA (deduped by fingerprint). App bugs stay in your repo.

Safety: never auto-merges, never deploys, never touches secrets. Feedback payloads are redacted before send.

Integrations guide →

---

Monorepo

packages/
  dna-cli/        CLI
  dna-core/       Scanner, wizard, marketplace
  dna-runtime/    Runtime + adapters
  dna-immune/     Classifier + DNA platform detection
  dna-feedback/   Upstream feedback (sanitize, queue, ingest)
  dna-github/     GitHub API
  dna-ai/         AI repair
  dna-config/     Schemas
  dna-templates/  Snippets

apps/
  examples/       Express + Vite demos
  web/            dna.humaan.app — landing + marketplace
  marketplace/    Legacy standalone API (local dev)

pnpm install && pnpm build && pnpm test

Development guide →

---

Documentation

Full wiki: docs/README.md · Browse locally: pnpm run wiki:dev

Section	Start here
Business	Business strategy
Product	Product concept · Portfolio install · Marketplace
Design	Naming conventions
Delivery	Brownfield / IVF
Engineering	Quick start · CLI reference
Quality	Testing strategy

Also
Changelog	Releases and migrations
Team Testing	Colleague pilot guide
Contributing	PR guidelines
LOCAL_WIKI.md	Wiki commands

---

Roadmap

DNA is evolving from project scaffold to a full delivery loop: init → feature factory → quality → Docker → GitHub push → CI. Track progress on the DNA Roadmap project board.

Item	Start	End	Status
Knowledge pack marketplace (~1045 packs)	Jan 2026	Jul 2026	Shipped
Marketplace purpose bundles (Purpose Combos) (27 combos)	Jul 2026	Jul 2026	Shipped
DNA always-on + AGENTS.md agent flow (v0.4.9)	Jul 2026	Jul 2026	Shipped
Legal advisor + delivery methodology (v0.4.9)	Jul 2026	Jul 2026	Shipped
Fastify, NestJS, Next.js runtime adapters	Feb 2026	Apr 2026	Shipped
npx @superhumaan/dna-by-humaan on npm (v0.4.0)	Mar 2026	Jul 2026	Shipped
Supply-chain hardening + Socket transparency (v0.4.4)	Jul 2026	Jul 2026	Shipped
Zero npm dependencies (v0.4.5)	Jul 2026	Jul 2026	Shipped
npm dna doctor workbench asset path fix (v0.4.6)	Jul 2026	Jul 2026	Shipped
Upstream feedback — DNA platform auto-report (v0.4.8)	Jul 2026	Jul 2026	Shipped
Prompt stem packs + intelligence library	Jul 2026	Jul 2026	Shipped
Strategy stem ladder (Golden Circle → canvases → OKRs/KPIs → Now/Next/Later; catalog v7)	Jul 2026	Jul 2026	Shipped
Day-to-day stems (admin, Tauri, fleet, PR, preview, a11y/perf, incident, MCP, i18n; 103 stems, catalog v8)	Jul 2026	Jul 2026	Shipped
Product intelligence stems (diagnose/SWOT/competitors/upgrade leverage; catalog v7)	Jul 2026	Jul 2026	Shipped
End-to-end delivery pipeline	May 2026	Jul 2026	Shipped
Interactive onboarding wizard	May 2026	Jun 2026	Shipped
Feature factory v2 + admin portal pattern	May 2026	Jun 2026	Shipped
Local quality module (dna quality)	May 2026	Jul 2026	Shipped
CI, Docker, and git hooks generators	Jun 2026	Jul 2026	Shipped
Doctor orchestrator + dna ivf	Jun 2026	Jul 2026	Shipped
IVF UI layer stack (MUI, mobile, shared library)	Jun 2026	Jul 2026	Shipped
GitHub integration package	Jun 2026	Jul 2026	Shipped
Runtime SQLite storage	Jun 2026	Jul 2026	Shipped
Preview deployment workflow	Jul 2026	Aug 2026	Shipped
DNA Lab — production observability at /labs	Jul 2026	Jul 2026	Shipped
Lab hardening + Aggressive Repair Loop (v0.6.3)	Jul 2026	Jul 2026	Shipped
Lab UI v4 + runtime depth + EPIPE/repair harden (v0.6.4)	Jul 2026	Jul 2026	Shipped
Lab gateway auth + honest pairing init (v0.6.5)	Jul 2026	Jul 2026	Shipped
DNA pairing is DNA-only (v0.6.6)	Jul 2026	Jul 2026	Shipped
Lab UI Humaan admin parity (v0.6.7)	Jul 2026	Jul 2026	Shipped
Lab CI billing blocker + cleanup anti-cascade (v0.6.8)	Jul 2026	Jul 2026	Shipped
Lab pairing paste-first without init (v0.6.9)	Jul 2026	Jul 2026	Superseded by store-first (v0.6.11)
Lab pairing store-first + gateway allowlist (v0.6.11)	Jul 2026	Jul 2026	Shipped
Express 5 optional peer (v0.6.12)	Jul 2026	Jul 2026	Shipped — express@^4 || ^5
Production health & residual closure (v0.6.13)	Jul 2026	Jul 2026	Shipped — shared Lab state, strict CI, coverage, Playwright, /health
Lab analytics Overview + Sentry-density Issues (v0.6.14)	Jul 2026	Jul 2026	Shipped — KPIs/batteries/charts; issue sparklines + deep detail
Lab upgrade DX — nested install detect + disk UI (v0.6.15)	Jul 2026	Jul 2026	Shipped — health version, dna lab installs --fix
Lab Refresh UX + Copy issue + install-safe upgrade (v0.6.16)	Jul 2026	Jul 2026	Shipped — disable/spin Refresh; doctor/update align Lab installs
Lab alert dark theme + force Refresh (v0.6.17)	Jul 2026	Jul 2026	Shipped — readable install banner; Refresh always shows busy state
Lab APIs reference + deep links + open-auth fix (v0.6.18)	Jul 2026	Jul 2026	Shipped — full API docs; URL tabs; requireAuthInProduction honored
Project git naming for AI commits/PRs (v0.6.23)	Jul 2026	Jul 2026	Shipped — [Tag] on commits/PRs from config; repair uses host project
npm + GitHub listing polish (v0.6.24)	Jul 2026	Jul 2026	Shipped — shorter description, hero READMEs, live health link
First-party GitHub OAuth app	Jul 2026	Sep 2026	Shipped — setup script + OAuth scaffolding
IVF Phase 4b — shared library extraction	Aug 2026	Oct 2026	Shipped
Multi-project CellularMemory sync	Oct 2026	Jan 2027	Shipped
Impressions drift → auto PR suggestions	Oct 2026	Feb 2027	Shipped
Platform feature codegen (SSO, multi-tenant, flags)	Nov 2026	Feb 2027	Shipped
Multi-tenant gradual rollout patterns	Jan 2027	Mar 2027	Shipped
Bundle scorecard CLI	Aug 2026	Aug 2026	Planned — XS
GDPR combo outcome gate	Aug 2026	Aug 2026	Planned — S
Repair outcome → CellularMemory	Aug 2026	Aug 2026	Planned — S
force-repair fingerprint ranking	Aug 2026	Sep 2026	Planned — S
dna lab immune-report	Sep 2026	Sep 2026	Planned — XS
Architecture graph JSON	Sep 2026	Sep 2026	Planned — S
Lab Architecture tab	Sep 2026	Oct 2026	Planned — S
Blast-radius in dna context	Oct 2026	Oct 2026	Planned — XS
Memory snapshots	Oct 2026	Oct 2026	Planned — S
dna memory diff	Oct 2026	Nov 2026	Planned — S
Lab Memory timeline	Nov 2026	Nov 2026	Planned — XS
dna factory run --dry-run	Nov 2026	Nov 2026	Planned — S
Lab factory approve/reject	Nov 2026	Nov 2026	Planned — S
Editor extension + quality status	Nov 2026	Dec 2026	Planned — S
Extension blockers panel	Dec 2026	Dec 2026	Planned — S
DNA MCP: context + doctor	Jan 2027	Jan 2027	Planned — S
DNA MCP: quality + memory + repair	Jan 2027	Feb 2027	Planned — S
document --from-code confidence	Feb 2027	Feb 2027	Planned — S
Lab friction signals	Feb 2027	Mar 2027	Planned — S
Hosted DNA Cloud design spike	Mar 2027	Mar 2027	Planned — S
Hosted Lab auth prototype	Apr 2027	May 2027	Planned — M (after #48)

Milestone: v0.9.0 — Next product bets · Board: DNA Roadmap

---

Sponsors

DNA is MIT-licensed and maintained in the open. Sponsorship funds hosting, security updates, and the marketplace — not premium features.

No sponsors yet — be the first.

License

MIT © 2026 Humaan by Superlite

See LICENSE for full text.