---
title: Dark Factory Wiki Schema
slug: SCHEMA
type: schema
created: 2026-06-17
updated: 2026-06-17
status: active
tags:
  - schema
  - llm-wiki
  - dark-factory
sources:
  - karpathy-llm-wiki-gist-2026-04-04
related:
  - index
  - log
  - llm-wiki-pattern
confidence: high
contradictions: []
bead_refs:
  - dark-factory-rr4
---

# 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 synthesis, and query pages preserve answers future agents are likely to need again.

## Frontmatter

Every Markdown page uses the same fields:

- `title`: human-readable title.
- `slug`: stable page ID. Use lowercase kebab case except infrastructure pages such as `SCHEMA`.
- `type`: one of `index`, `schema`, `log`, `source`, `concept`, `system`, `comparison`, or `query`.
- `created`: date first added to this wiki.
- `updated`: date last materially changed.
- `status`: `active`, `seed`, or `needs-review`.
- `tags`: compact retrieval hints.
- `sources`: source card slugs or raw URLs that support the page.
- `related`: internal page slugs that should be read next.
- `confidence`: `high`, `medium-high`, `medium`, or `low`.
- `contradictions`: preserved tensions, disagreements, or caveats.
- `bead_refs`: Beads issue IDs connected to the work.

## Page Types

Source pages store provenance, capture dates, compact takeaways, and explicit caveats. Concept pages store reusable vocabulary and cross-source claims. System pages describe concrete systems or subsystems. Comparison pages sharpen boundaries. Query pages answer likely future questions with reusable synthesis.

## Claim Handling

Do not paste full article text into the wiki. Use source cards and outbound source URLs as provenance. When a claim combines multiple sources, prefix it with `inference:` so future agents can distinguish synthesis from direct source reporting.

## Link Conventions

Use wikilinks such as [[dark-factory]] for local pages. The link text must match a local page slug or infrastructure page. Use normal Markdown links only for source URLs and external references.