---
title: Dark Factory Wiki Log
slug: log
type: log
created: 2026-06-17
updated: 2026-06-17
status: active
tags:
  - log
  - ingest
  - dark-factory
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:
  - index
  - SCHEMA
confidence: high
contradictions:
  - The initial ingest compiles point-in-time repository snapshots; repository claims should be refreshed before current operational decisions.
bead_refs:
  - dark-factory-rr4
---

# Dark Factory Wiki Log

## 2026-06-17 Visual Browsing Layer

Added a standalone offline browsing layer for humans:

- `index.html`: generated light-theme wiki browser with sticky navigation, search, type filters, page cards, backlinks, source/provenance chips, open tensions, maintenance links, and an inline factory graph.
- `wiki-data.json`: generated structured sidecar with every Markdown page, unique slugs, page types, tags, source URLs, related links, backlinks, tensions, and graph edges.
- `build_viewer.py`: Python standard-library generator and `--check` validator.

Canonical knowledge remains in the Markdown wiki pages. Regenerate with `python3 reports/wiki/build_viewer.py` and verify with `python3 reports/wiki/build_viewer.py --check`.

## 2026-06-17 Initial Ingest

Created `reports/wiki/` as a persistent LLM wiki for the dark factory source set.

## Sources Captured

- [Dan Shapiro: You Don't Write the Code. You Don't Read the Code Either.](https://www.danshapiro.com/blog/2026/02/you-dont-write-the-code/)
- [2389: The Dark Factory Is a .dot file](https://2389.ai/posts/the-dark-factory-is-a-dot-file/)
- [strongdm/attractor](https://github.com/strongdm/attractor)
- [Karpathy LLM Wiki gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
- [jleechanorg/dark-factory](https://github.com/jleechanorg/dark-factory), observed `main` HEAD `5449ecc1e5115afda6dca2f8cd49da2dd61a24ae`
- [jleechanorg/agent-orchestrator](https://github.com/jleechanorg/agent-orchestrator), observed `main` HEAD `3923e3cce815b541af59c2756945d184fde4ac25`

## Pages Created

- Infrastructure: [[SCHEMA]], [[index]], [[log]].
- 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]].
- Concepts: [[dark-factory]], [[software-factory]], [[llm-wiki-pattern]], [[nlspec]], [[dot-pipeline]], [[attractor-pattern]].
- Systems: [[strongdm-attractor]], [[digital-twin-universe]], [[cxdb]], [[healer]], [[agentic-pipeline-runner]], [[agent-orchestrator]].
- Comparisons: [[llm-wiki-vs-rag]], [[code-review-vs-validation]], [[tool-nodes-vs-llm-nodes]], [[specs-vs-code]].
- Queries: [[what-is-the-durable-artifact-in-a-dark-factory]], [[how-do-dark-factories-validate-without-reading-code]], [[how-do-dot-pipelines-map-to-agent-workflows]].

## Synthesis Notes

- Preserved the main tension: dark factory aspirations reduce human code reading, but validation design and human-owned policy become more important.
- Added repository sources requested after initial implementation started: [[jleechanorg-dark-factory-repo]] and [[jleechanorg-agent-orchestrator-repo]].
- Distinguished [[agentic-pipeline-runner]] from [[agent-orchestrator]]: the runner owns workflow graph execution; the orchestrator owns worker/session/worktree/PR lifecycle.