@superhumaan/dna-by-humaan
Advanced tools
DNA by Humaan — one doctor install: 59 stem packs, rules, detection, portfolio memory, 897-pack marketplace, runtime observer, feature factory, and AI repair for TypeScript squads
Git remembers your code. DNA remembers your system.
Run
npx @superhumaan/dna-by-humaan doctor— “No amount of money ever bought a second of time.”
One squad, many products? Install on the parent folder — one brain for every related app. Portfolio install →
One npm package. One install. Everything included.
DNA by Humaan is an open-source project brain, runtime observer, 59 prompt stem packs, 897-pack knowledge marketplace, and AI-assisted repair system for TypeScript squads.
Recommended: npx @superhumaan/dna-by-humaan doctor — one command for stems, rules, detection, memory, runtime, CI, and feature factory. Portfolio install →
| Website | dna.humaan.app |
| Marketplace | dna.humaan.app/marketplace |
| Intelligence | dna.humaan.app/intelligence — 59 prompt stem packs + /dna-* CLI commands |
| Repository | github.com/superhumaan/DNA |
| npm | @superhumaan/dna-by-humaan |
| Supply chain | Socket.dev report · SECURITY.md |
DNA is published from github.com/superhumaan/DNA under the @superhumaan npm scope with MIT license, npm provenance, and zero production npm dependencies (v0.4.5+).
Security scanners may flag network, shell, or filesystem access — expected for a CLI that scaffolds projects, talks to GitHub, and syncs knowledge packs. The npm package no longer pulls third-party runtime libraries (commander, zod, simple-git, etc.); those capabilities are implemented in-tree and bundled into dist/. See SECURITY.md — Supply-chain transparency for the full endpoint list and when each runs.
Verify your install:
npm view @superhumaan/dna-by-humaan repository.url
dna --version
npx @superhumaan/dna-by-humaan doctor
Doctor is the recommended entry point — it scaffolds .DNA/, CI, runtime, Docker, hooks, GitHub sign-in, and auto-wires middleware. Use init only when you want the interactive wizard first.
# Production runtime (same package)
pnpm add @superhumaan/dna-by-humaan
Install once on the parent folder — one command, everything included:
cd ~/work/your-squad-folder
npx @superhumaan/dna-by-humaan doctor
Included in one doctor | |
|---|---|
.DNA/ intelligence | behaviour, CellularMemory, immune system, neuralNetwork |
59 stem packs + /dna-* commands | guidelines, expectations, workflows in .DNA/stems/ |
| AI workbench | AGENTS.md, Cursor + Claude rules/skills — always on |
| Detection | stack, monorepo apps, AI tools, GitHub, healthcare/legal domain, drift |
| Feature factory | 9-role loop, quality gates, same template every feature |
| Runtime + CI | auto-wired observer, GitHub Actions, pre-push hook, Docker |
| 897 knowledge packs | foundation from scan + marketplace |
One brain for every related app — how they connect, what broke, what to fix. The install teams keep like tsconfig.json.
DNA is not a documentation generator. It is:
| Capability | What it does |
|---|---|
| Project intelligence | Structured .DNA/ context AI tools can actually use |
| AI behaviour layer | Rules governing how Cursor, Copilot, and Claude work on your stack |
| Runtime observer | Classifies production errors with project-specific context |
| Knowledge marketplace | 897 curated packs — frameworks, cloud, healthcare, compliance, legal, payments, gaming, ERP |
| Tiered compliance | GDPR, UK GDPR, HIPAA, ISO 27001, SOC 2, PCI DSS — startup → enterprise |
| GDPR reference library | 85+ governance, technical, and AI policy templates (bundled in CLI assets) |
| Platform catalog | Production patterns from DNA reference systems (AIStudio, ColorParty, Humaan Ops, Soli) |
| IVF (brownfield) | Install into existing codebases — analyze, document, phased migration plans |
| GitHub automation | Contextual issues and AI-assisted repair PRs |
| Software immune system | Severity, category, and discipline classification |
| CellularMemory | Learns from your project's history |
npx @superhumaan/dna-by-humaan doctor
npm install # if package.json was updated
dna scan
dna context cursor
dna analyze # Deep structure, auth, IVF gap analysis
dna document --from-code # Reverse-engineer Impressions from code
dna plan ivf --quote "Add DNA to our Express monolith"
| Command | What it does |
|---|---|
dna init | Scaffold .DNA/ + DNA/Impressions/ |
dna analyze | Brownfield analysis — structure, auth, IVF gaps |
dna document --from-code | Generate Impressions from existing code |
dna plan ivf | Integrating Vertical Functions — phased migration plan |
dna scan | Detect stack, tests, CI, risks |
dna context cursor | AI-ready context for Cursor / Copilot / Claude |
dna update | Upgrade CLI + re-apply all installed knowledge packs + force re-inject always-on AI rules |
dna workbench install | Refresh DNA Workbench + 59 prompt stem packs + /dna-* commands + AGENTS.md |
dna stems list | List prompt stem packs (analyze, ship, agent-loop roles, …) |
dna stems show <id> | Copy variants and file paths for one stem |
dna commands install | Refresh /dna-* CLI slash commands only (also installed by init/doctor/update) |
dna generate feature <id> | Scaffold audit-logging, sso, multi-tenant, feature-flags, gradual-rollout |
dna memory sync | Sync CellularMemory from team registry |
dna plan rbac | RBAC from plain language → permission matrix |
dna plan compliance | ISO / GDPR / HIPAA / SOC 2 by org tier |
dna compliance list | Startup → enterprise compliance catalog |
dna context compliance | Load tiered compliance knowledge for AI |
dna platform list | DNA production feature catalog |
dna plan feature <id> | End-to-end plans — SSO, admin, flags, Azure, CRM, CMS |
dna marketplace list | Browse 897 knowledge packs |
dna legal advise | Legal advisor — jurisdictions, sectors, engineering gates |
dna plan legal | Legal rollout plan + regional packs |
dna methodology | Delivery profile — Scrum, Kanban, Shape Up, ticket/doc systems |
dna marketplace install <id> | Install packs into .DNA/knowledge/ |
dna validate | Check against Behaviour rules |
dna doctor | Full health check |
dna feedback report | Report DNA-platform issue upstream (sanitized) |
dna feedback sync | Flush offline feedback queue |
dna runtime install | Framework snippets for production observer |
dna lab install | Scaffold DNA Lab at /labs + auto-wire middleware |
dna lab serve | Local Lab at http://localhost:3200/labs (no login on localhost) |
dna register lab --url <url> | Pair local CLI to production Lab (148-digit code) |
dna dashboard | Legacy alias for dna lab serve |
dna github connect | Wire GitHub issues + repair workflow |
dna ai repair | AI-assisted fix suggestions (dry-run safe) |
dna marketplace list
dna marketplace search --query healthcare
dna marketplace search --query fhir
dna marketplace install frameworks/nextjs
dna marketplace install compliance/gdpr
dna marketplace install healthcare/fhir-r4
dna update
Live catalog: dna.humaan.app/marketplace · Offline bundled fallback included.
| Layer | Count | Examples |
|---|---|---|
| Core (frameworks, compliance, DNA stack) | 11 | Next.js, GDPR, RBAC |
| Stem delivery surfaces | 21 | stem/* |
| Language stems (i18n AI) | 18 | languages/en, languages/vi, … |
| Catalog expansion v1 | 79 | CMS, payments, modern frameworks |
| Wave 2 | 283 | Healthcare (45), databases, cloud, AI/LLM |
| Wave 3 | 187 | Enterprise ERP, gaming/XR, clinical AI |
| Wave 4 | 142 | Regional cloud, ORMs, security depth |
| Wave 5 | 27 | FinOps, data mesh, store distribution |
| Total | 897 |
Healthcare: 55 packs — FHIR R4, Epic, Cerner, Redox, HL7, MDR, patient portal, clinical AI, HIE networks, and more.
Stack archetypes: Auto-detected profiles for healthcare-fhir, fintech-plaid, ecommerce-shopify, gaming-unity, erp-sap-integration, ai-llm-saas, cloud-aws-saas, observability-production, and 35+ more.
Import from the same package in your server:
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.
dna runtime install # Auto-wire framework snippets
dna lab install # Scaffold DNA Lab at /labs
dna lab serve # Local Lab — http://localhost:3200/labs
DNA Lab at /labs complements external uptime tools (it does not replace ping monitoring).
| Mode | Access |
|---|---|
| Local | dna lab serve — open http://localhost:3200/labs, no login |
| Production | dna register lab --url https://your-app.com must print Production notified → paste Pairing ID + code at /labs → create account. Behind Connect: allowlist POST /api/dna/labs/pairing/init (see .DNA/lab/gateway-public-paths.md) |
UI (v0.6.7+): Humaan admin parity — DNA logo only, primary pill buttons, large pill tabs, search → filters → data tables, collapsible Monitor/Delivery nav. Release notes →.
After npm install @superhumaan/dna-by-humaan@latest, restart the API that mounts Lab — npx …@x.y.z alone does not refresh /labs.
import { createLabMiddleware } from "@superhumaan/dna-by-humaan/lab";
app.use(createLabMiddleware({ projectRoot: process.cwd() }));
Release tracking and source maps: POST /api/dna/labs/releases, POST /api/dna/labs/sourcemaps.
DNA classifies live errors with your project's Behaviour rules and writes .DNA/runtime/issues.jsonl. Use alongside Sentry — DNA adds why and project context, not replacement.
Tiered implementation for startup → enterprise:
dna compliance list
dna plan compliance --frameworks gdpr,iso27001 --tier sme
dna context compliance
Frameworks: GDPR, UK GDPR, HIPAA, ISO 27001, SOC 2, PCI DSS.
Bundled GDPR reference library (85+ documents): policies, DPIA templates, AI governance, technical controls, external-facing privacy/terms.
dna github login
dna github connect --owner ORG --repo REPO
dna feedback report --message "DNA error" --dry-run
dna feedback sync
dna ai connect --provider mock
dna ai repair --file issue.json --dry-run
Local: high/critical runtime → your repo. Upstream: DNA-platform failures → sanitized reports to superhumaan/DNA (dna-only default). Safety: never auto-merges, never deploys, never touches secrets.
your-project/
├── .DNA/ # AI-first intelligence (machines)
│ ├── behaviour/ # rules for Cursor, Copilot, Claude
│ ├── knowledge/ # 897-pack marketplace installs
│ ├── CellularMemory/ # learned history
│ ├── immuneSystem/ # classification rules
│ └── runtime/ # classified production issues
└── DNA/Impressions/ # human-facing docs (people)
├── product/
├── architecture/
└── security/
# 1. Give the project a brain
npx @superhumaan/dna-by-humaan init -y
# 2. Install stack knowledge
dna marketplace install frameworks/nextjs
dna marketplace install compliance/gdpr
# 3. Feed your AI editor
dna context cursor
# 4. Protect your API in production
pnpm add @superhumaan/dna-by-humaan
dna runtime install
Commit .DNA/ and DNA/ so your team shares one brain.
| DNA is | DNA is not |
|---|---|
| Project intelligence for AI | A docs generator |
| Behaviour rules for your stack | A linter replacement |
| Runtime issue classification | A Sentry replacement — use both |
| 897 knowledge packs + GDPR library | A hosted SaaS — runs in your repo |
| GitHub issue + repair automation | Auto-merge or auto-deploy |
| Guide | Description |
|---|---|
| Getting started | First project in 10 minutes |
| Brownfield / IVF | Install into existing projects |
| Concepts | Behaviour, memory, immune system |
| CLI reference | Every command |
| Runtime observer | Express, Fastify, NestJS, Next.js |
| Marketplace | 897 knowledge packs |
| Compliance | Tiered GDPR, HIPAA, ISO, SOC 2 |
| Platform catalog | DNA production patterns |
| Changelog | Releases and migrations |
| Integrations | GitHub issues + AI repair |
| Team testing | Colleague pilot guide |
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.
MIT © Humaan by Superlite
FAQs
DNA by Humaan — one doctor install: 59 stem packs, rules, detection, portfolio memory, 897-pack marketplace, runtime observer, feature factory, and AI repair for TypeScript squads
The npm package @superhumaan/dna-by-humaan receives a total of 3,478 weekly downloads. As such, @superhumaan/dna-by-humaan popularity was classified as popular.
We found that @superhumaan/dna-by-humaan demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
11 malicious NuGet tools pose as game cheats to deploy Windows payloads, track hosts, and use Google Sheets for telemetry and control.
Research
/Security News
4 compromised asyncapi packages deliver miasma botnet loader on macOS, Linux and Windows.
Research
/Security News
A compromised jscrambler npm release added a malicious preinstall hook that runs hidden native binaries on Linux, macOS, and Windows.