The Forge Working Hall
Operational surfaces, not documentation rooms.
Status: Stabilized Date: 2026-05-21 Series: Forge Architecture
1. The Split
The Forge has two halls:
| Hall | Purpose | Contains | |------|---------|----------| | Working Hall | Operational surfaces | Chamber, Observatory, Runtime, Ecology, Dashboard, Experiments, Promptsmith | | Knowledge Vault | Stabilized knowledge | Bibliotheca (philosophy, atlas, research, findings, primers, bonfire) |
The Working Hall is where work happens. The Knowledge Vault is where understanding lives.
They are not the same thing. They should not be confused.
2. Working Hall Principles
2.1 Operational surfaces are lean
A working surface shows controls, data, and state. It does not explain itself. Explanations belong in the Knowledge Vault.
Good: A panel showing "Correction Load: 5 records" with a table of data. Bad: A panel explaining what correction load is, why it matters, and how to interpret it.
2.2 One meaning, one canonical home
If a concept exists in the Knowledge Vault, the Working Hall links to it rather than re-explaining it.
This prevents:
- Double entry (two versions of the same concept)
- Drift (versions diverging over time)
- Bloat (pages growing beyond their operational purpose)
2.3 The Forge is not a documentation project
The Forge is a convergence environment. Its pages are workspaces, not textbooks. A page that explains more than it operates has lost its purpose.
3. What Belongs Where
Working Hall (Forge pages)
- Controls, inputs, buttons, toggles
- Data displays, tables, readings
- Session state, runtime traces
- Sample data that demonstrates operational behavior
- Concise labels that identify what a panel does
- Links to the Knowledge Vault for "what is this?" questions
Knowledge Vault (Bibliotheca)
- Foundational concepts and definitions
- Philosophy and design rationale
- Architecture decisions and their reasoning
- Research manuscripts and findings
- Primers that explain how to use the Working Hall
- Bonfire — continuity residue and cooling notes
4. The Refactor Pattern
When moving explanatory content from Working Hall to Knowledge Vault:
- Identify the explanatory block (primer, concept list, philosophy section)
- Create or locate the canonical manuscript in Bibliotheca
- Replace the block with a concise operational label + link
- Verify no concept has two competing homes
5. Relationship to Archive Hall
The Archive Hall (/archive) is the Forge's front door to the Knowledge Vault. It provides browsable access to Bibliotheca manuscripts, findings, research, primers, and bonfire content — all from within the Forge UI.
The Archive Hall is not the Knowledge Vault itself. It is the window into it.
Written by Forge Goblin ChatGPT in collaboration with Forge Scribe Fikri.