28 Markdown pages 214 graph edges 42 tensions 11 source URLs

Dark Factory LLM Wiki

A local, source-backed browser for the dark factory operating model, DOT pipeline layer, validation stack, orchestrator boundary, and maintained LLM wiki corpus.

6concept pages
6system pages
4comparisons
6source cards
3query notes

Showing all wiki pages.

Start Here

The reading path starts with the operating model, then moves through durable artifacts, graph execution, validation, and orchestration boundaries.

Factory Map

The graph links the durable process artifact, runner, validation evidence, repair loop, and adjacent worker orchestration layer.

Intent stays human-owned.Specs, gates, threat models, and risk policy remain the durable control surface.
DOT is the process artifact.The graph captures sequencing, agent/tool calls, joins, checks, and human gates.
Validation replaces routine diff reading.CXDB, Healer, holdouts, digital twins, CI, and independent review provide evidence.
Orchestration is adjacent.Agent Orchestrator manages sessions and PR workflows; the runner owns graph execution.

Concepts & Systems

Reusable vocabulary and concrete subsystems for the dark factory model.

concept confidence medium-high updated 2026-06-17

Attractor Pattern

The attractor pattern is the repeated three-layer architecture that appears in StrongDM Attractor-style systems:

attractor architecture convergence
concept confidence medium-high updated 2026-06-17

Dark Factory

A dark factory is a software production model where humans specify intent and validation policy while automated agents generate, test, repair, and ship code with minimal direct human reading of generated diffs.

dark-factory automation validation software-engineering
concept confidence high updated 2026-06-17

DOT Pipeline

A DOT pipeline is a Graphviz directed graph used as an executable workflow definition. Nodes represent work, tools, gates, human approvals, joins, exits, or model calls. Edges represent routing, dependencies, retries, success/failure...

dot pipeline graphviz process-graph
concept confidence high updated 2026-06-17

LLM Wiki Pattern

The LLM wiki pattern turns repeated research into a durable Markdown knowledge base. Raw sources remain provenance; the wiki stores curated source cards, compiled topic pages, comparison pages, query notes, backlinks, and update logs.

llm-wiki knowledge-base markdown
concept confidence high updated 2026-06-17

NLSpec

An NLSpec is a natural-language specification written to be implemented by coding agents. In the StrongDM Attractor repository, NLSpecs define desired behavior for a unified LLM client, a coding agent loop, and a DOT pipeline engine.

nlspec specification agent-readable
concept confidence medium updated 2026-06-17

Software Factory

A software factory is a repeatable production system for turning intent into software artifacts. In this wiki, it is the broader category; dark-factory is the lights-off variant that tries to avoid human code reading.

software-factory industrialization automation
system confidence high updated 2026-06-17

Agent Orchestrator

Agent Orchestrator is a fleet/session orchestration system for AI coding agents. The jleechanorg fork manages workers in isolated git worktrees and routes CI failures, review comments, and status changes back to those workers.

orchestration agents worktrees ci pr-workflow
system confidence high updated 2026-06-17

Agentic Pipeline Runner

An agentic pipeline runner executes a dot-pipeline by parsing the graph, validating structure, invoking node handlers, routing outcomes, recording events, and coordinating agents or tools.

runner pipeline agents dot
system confidence medium-high updated 2026-06-17

CXDB

CXDB is the observability/event-log layer described by Shapiro and implemented in the local dark-factory repository as a SQLite event log for pipeline runs.

observability event-log sqlite diagnosis
system confidence medium-high updated 2026-06-17

Digital Twin Universe

The digital twin universe is StrongDM's reported local reproduction of enterprise SaaS systems used to validate generated software against realistic external behavior.

testing simulation validation enterprise-saas
system confidence medium-high updated 2026-06-17

Healer

Healer is the diagnosis and repair-support system layered on top of cxdb. In the dark-factory repository, df-healer clusters failures from the event log into actionable diagnoses.

diagnosis repair-loop observability

Comparisons

Boundary pages that sharpen tradeoffs and prevent category drift.

comparison confidence medium-high updated 2026-06-17

Code Review vs Validation

Code review asks humans or reviewers to inspect code changes directly. Validation asks systems to prove the change satisfies behavior, safety, policy, and evidence requirements.

code-review validation gates security
comparison confidence medium-high updated 2026-06-17

Specs vs Code

Specs describe intent, behavior, process, and validation. Code is the executable artifact produced from those specs. Dark factory sources push the durable boundary toward specs, graphs, tests, and evidence rather than generated code.

specs code durable-artifacts
comparison confidence high updated 2026-06-17

Tool Nodes vs LLM Nodes

Tool nodes run deterministic commands, checks, transformations, or integrations. LLM nodes delegate reasoning, planning, code generation, review, or synthesis to a model-backed agent.

dot tools llm pipeline-design

Source Cards

Provenance pages with captured source URLs and compact implications.

source confidence high updated 2026-06-17

2389: The Dark Factory Is a .dot file

StrongDM's Attractor NLSpecs describe three layers: unified LLM client, coding agent loop, and DOT-based pipeline engine.

source dot pipeline attractor dark-factory
source confidence high updated 2026-06-17

Dan Shapiro: You Don't Write the Code. You Don't Read the Code Either.

The core operating shift is: the AI writes code, and reviewing every pull request becomes the bottleneck.

source dark-factory strongdm validation
source confidence high updated 2026-06-17

jleechanorg/agent-orchestrator Repository

Captured: 2026-06-17. Observed main HEAD: 3923e3cce815b541af59c2756945d184fde4ac25. Provenance: public GitHub repository README, ARCHITECTURE.md, and local shallow clone inspection.

source repository orchestration worktrees agents
source confidence high updated 2026-06-17

jleechanorg/dark-factory Repository

Captured: 2026-06-17. Observed main HEAD: 5449ecc1e5115afda6dca2f8cd49da2dd61a24ae. Provenance: public GitHub repository README and local shallow clone inspection.

source repository dark-factory dot cxdb
source confidence high updated 2026-06-17

Karpathy LLM Wiki Gist

Created: 2026-04-04. Captured: 2026-06-17. Provenance: primary gist by Andrej Karpathy describing the LLM wiki pattern.

source llm-wiki knowledge-base rag
source confidence high updated 2026-06-17

StrongDM Attractor NLSpec Repository

Source URLs: GitHub repository, README, Attractor spec, Coding agent loop spec, Unified LLM spec

source strongdm attractor nlspec dot

Query Notes

Reusable answers to questions future agents are likely to ask again.

query confidence medium-high updated 2026-06-17

How Do Dark Factories Validate Without Reading Code?

They replace routine diff reading with layered outcome evidence.

query validation code-review gates
query confidence high updated 2026-06-17

How Do DOT Pipelines Map To Agent Workflows?

DOT pipelines map workflow structure to executable nodes. Some nodes invoke agents; others run deterministic tools, gates, joins, or human approvals.

query dot workflows agents
query confidence medium-high updated 2026-06-17

What Is The Durable Artifact In A Dark Factory?

Short answer: the durable artifact is the factory definition, not just the generated code.

query durable-artifacts dark-factory

Open Tensions

Caveats and disagreements preserved from page frontmatter and tension sections.

This wiki is a curated synthesis; source cards remain the provenance layer for checking exact claims.

The initial ingest compiles point-in-time repository snapshots; repository claims should be refreshed before current operational decisions.

Independent convergence is plausible from the sources, but the evidence is a small cluster of related implementations and specs.

Dark factory rhetoric minimizes human code reading, but practical systems still need humans to define intent, gates, threat models, and acceptable risk.

Human gates may be necessary, but too many gates recreate the manual bottleneck.

Disposable generated code sounds freeing, but the runner, tests, and observability stack become critical infrastructure.

"Do not read code" creates a security problem unless validation can catch unsafe behavior and supply-chain drift.

DOT is simple and inspectable, but complex software lifecycle graphs can still become hard to reason about without schema validation and visual conventions.

LLM-maintained synthesis compounds learning, but can also compound stale or mistaken synthesis unless source cards and logs stay current.

conceptNLSpec

Natural language specs are accessible to agents and humans, but ambiguity must be controlled with validation and examples.

A software factory can still include human reading and manual approval; dark factory is a more aggressive variant.

It automates worker feedback loops, but its README still reserves merge/review and portability decisions for human judgment.

The runner can be considered disposable relative to the graph, but runner correctness is still load-bearing for safety and reproducibility.

systemCXDB

Observability can diagnose failures after the fact, but it does not by itself prove generated code is safe.

Simulation can improve validation fidelity, but it can also hide production-only failure modes if the twin is stale or incomplete.

systemHealer

Repair loops reduce human debugging burden, but a wrong diagnosis can send agents into repeated ineffective fixes.

Attractor is described as a system, but the cited repository is primarily a specification corpus.

Human code review catches design and security issues that tests may miss; dark factory systems try to move that assurance into automated gates and independent review.

comparisonLLM Wiki vs RAG

A wiki preserves synthesis but can go stale; RAG preserves access to raw material but can repeatedly miss the same synthesis.

comparisonSpecs vs Code

Treating code as disposable is useful for generated implementations, but production systems still depend on correct executable code at runtime.

Overusing tools can make the graph rigid; overusing LLM nodes can make runs expensive, nondeterministic, and hard to debug.

The post says the factory code is disposable, but its examples also show substantial runner architecture and validation behavior that must be implemented carefully.

This source mixes product narrative, implementation notes, and advocacy. Treat claims about what is "the product" as a position, not a settled industry standard.

The post says pipelines are the durable artifact, while dan-shapiro-you-dont-write-code-2026-02-13 emphasizes validation systems and factory operation.

The README describes runner code as disposable, but the repository contains substantial engine, validation, observability, and benchmark code that future implementations should study.

This is an implementation repository and contains claims about its own state of the art; use it as implementation evidence, not as independent proof that the pattern is universally validated.

The gist encourages LLM-owned wiki maintenance, but durable usefulness still depends on human source selection and review.

The pattern does not eliminate the need for source verification, contradiction handling, or human correction.

The repository is framed as Attractor, but the visible artifact is a set of natural-language specifications rather than a runnable implementation.

Maintenance

Infrastructure pages and generated artifacts for refreshing the browser layer.

index confidence high updated 2026-06-17

Dark Factory LLM Wiki

This is a durable Markdown wiki for the dark factory source set. It compiles article, spec, and repository sources into reusable pages so future agents can start from the synthesized map before returning to raw sources.

index dark-factory llm-wiki
schema confidence high updated 2026-06-17

Dark Factory Wiki Schema

This wiki is a persistent Markdown knowledge base for the dark factory, software factory, DOT pipeline, NLSpec, and Attractor source set. It follows the llm-wiki-pattern: source cards preserve provenance, compiled pages preserve reusable...

schema llm-wiki dark-factory
log confidence high updated 2026-06-17

Dark Factory Wiki Log

Added a standalone offline browsing layer for humans:

log ingest dark-factory