---
title: Dark Factory LLM Wiki
slug: index
type: index
created: 2026-06-17
updated: 2026-06-17
status: active
tags:
  - index
  - dark-factory
  - llm-wiki
sources:
  - dan-shapiro-you-dont-write-code-2026-02-13
  - 2389-dark-factory-dot-file-2026-03-09
  - strongdm-attractor-nlspec
  - karpathy-llm-wiki-gist-2026-04-04
  - jleechanorg-dark-factory-repo
  - jleechanorg-agent-orchestrator-repo
related:
  - SCHEMA
  - log
  - dark-factory
  - agentic-pipeline-runner
confidence: high
contradictions:
  - This wiki is a curated synthesis; source cards remain the provenance layer for checking exact claims.
bead_refs:
  - dark-factory-rr4
---

# 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.

## Best Starting Path

1. Read [[dark-factory]] for the operating model.
2. Read [[what-is-the-durable-artifact-in-a-dark-factory]] for the durable-artifact synthesis.
3. Read [[dot-pipeline]] and [[agentic-pipeline-runner]] for the executable workflow layer.
4. Read [[code-review-vs-validation]] before making claims about not reading generated code.
5. Read [[agent-orchestrator]] when work involves worker/session/PR orchestration.

## Infrastructure

- [[SCHEMA]]: frontmatter, page-type, provenance, and wikilink rules.
- [[index]]: this navigation page.
- [[log]]: ingest and maintenance history.

## Source Cards

- [[dan-shapiro-you-dont-write-code-2026-02-13]]: primary Shapiro article on not writing or reading generated code, StrongDM's validation posture, CXDB, and Healer.
- [[2389-dark-factory-dot-file-2026-03-09]]: primary 2389 post on DOT pipelines as the dark factory artifact and the attractor pattern.
- [[strongdm-attractor-nlspec]]: StrongDM Attractor NLSpec repository for unified LLM, coding loop, and DOT runner specs.
- [[karpathy-llm-wiki-gist-2026-04-04]]: LLM wiki pattern source that motivates persistent Markdown synthesis.
- [[jleechanorg-dark-factory-repo]]: concrete Python DOT pipeline runner repository with CXDB, Healer, backends, benchmarks, and holdout isolation.
- [[jleechanorg-agent-orchestrator-repo]]: AO fork repository for fleet/session/worktree/PR orchestration and evidence/skeptic automation.

## Concepts

- [[dark-factory]]: software production model where humans specify intent and validation policy while agents generate and validate code.
- [[software-factory]]: broader repeatable system for turning intent into software artifacts.
- [[llm-wiki-pattern]]: persistent Markdown synthesis pattern for compounding agent knowledge.
- [[nlspec]]: natural-language specification intended for coding agents to implement.
- [[dot-pipeline]]: Graphviz-directed process graph used as an executable workflow definition.
- [[attractor-pattern]]: three-layer convergence around LLM client, coding loop, and pipeline engine.

## Systems

- [[strongdm-attractor]]: specification corpus for Attractor-style software factory layers.
- [[digital-twin-universe]]: high-fidelity local test universe for validating generated systems.
- [[cxdb]]: event-log and observability layer for pipeline runs.
- [[healer]]: diagnosis layer that clusters factory failures and supports repair loops.
- [[agentic-pipeline-runner]]: runner that parses DOT graphs, invokes agents/tools/gates, and records outcomes.
- [[agent-orchestrator]]: worker/session/worktree/PR orchestration layer that can serve as a factory backend or adjacent substrate.

## Comparisons

- [[llm-wiki-vs-rag]]: maintained synthesis versus query-time retrieval over raw sources.
- [[code-review-vs-validation]]: human diff inspection versus layered outcome evidence.
- [[tool-nodes-vs-llm-nodes]]: deterministic tool execution versus model-backed reasoning nodes.
- [[specs-vs-code]]: durable intent/process artifacts versus generated executable output.

## Queries

- [[what-is-the-durable-artifact-in-a-dark-factory]]: answer to whether DOT, specs, validation, or code is the durable layer.
- [[how-do-dark-factories-validate-without-reading-code]]: validation stack for no-diff-review workflows.
- [[how-do-dot-pipelines-map-to-agent-workflows]]: mapping of graph nodes to agent, tool, gate, join, and human workflow roles.