Handbook
Forge Intelligence architecture alignment for PhysicsGenesis
Analysis basis: Forge Intelligence repository and handbook structure examined on 2026-07-22, plus the supplied Forge LCDL README.
Updated
Where the physics library belongs
The handbook is a generated static documentation surface. The writable source of truth is the forge-intelligence product repository. PhysicsGenesis should generate repository-native, reviewable artifacts and then allow the existing website build to publish selected documentation and wiki projections. It should not target generated HTML.
Existing architecture to reuse
Forge Intelligence already supplies:
- general and specific problem-class packs;
- per-pack policies with reasoning ladders, token budgets, and closed actions;
- one capability ↔ one LMeta unit ↔ one FI-local LCDL contract ↔ declared artifacts;
- typed artifact-envelope handoffs;
- multi-intelligence DAG composition with dependencies and fan-in;
- separate technical, autonomy, and evidence maturity axes;
- implemented allowlist gates;
- machine-canonical session records and generated human reports with a freeze gate;
- paired LMeta semantic and LCDL execution wiki projections;
- reusable reasoning, concept invention, experimentation, system modeling/simulation, creativity, and validation intelligences.
Forge LCDL contributes generic governed tasks such as schema extraction, routing, boolean and multi-label gates, contradiction scanning, problem decomposition, decision-pack planning, safe arithmetic planning, and reusable control-flow operators. PhysicsGenesis composes those primitives; it does not fork the runtime.
Gap this pack fills
The current generic knowledge-module representation is adequate for bounded changing facts but is too shallow for physics as a scientific knowledge system. Physics needs native distinctions among:
- quantities, dimensions, units, constants, and conventions;
- principles, empirical laws, constitutive laws, equations, derivations, approximations, and regimes;
- models, alternatives, parameters, observables, controls, and causal status;
- apparatus, protocols, measurements, calibration, uncertainty, datasets, and evidence roles;
- simulation models, numerical methods, residuals, convergence, invariants, and reproducibility;
- anomalies, falsification cases, rejected models, and replication;
- learner-visible material, hidden world truth, validator-only evaluators, and historian mappings;
- laboratory hazard and dual-use detail policy.
Runtime gap
Envelope execution, schema validity, and maturity status do not establish physics correctness. PhysicsGenesis therefore requires independent semantic validators and authenticated receipts for dimensions, derivations, numerical verification, measurement traceability, held-out prediction, interventions, replication, contamination, and safety.
Proposed problem classes
| Problem class | Proposed intelligence | Job |
|---|---|---|
physics/knowledge-ingest |
physics.knowledge-curation |
Curate typed objects from audited sources |
physics/quantity-normalize |
physics.metrology |
Normalize quantities, units, dimensions, constants, and uncertainty |
physics/model-formalize |
physics.theory-modeling |
Construct bounded model and theory cards |
physics/experiment-design |
physics.experimentation |
Design controlled discriminating experiments |
physics/simulation-assess |
physics.computational-simulation |
Verify numerical execution and reproducibility |
physics/law-discover |
physics.law-discovery |
Stage candidate quantities, laws, models, and invariants |
physics/model-validate |
physics.validation |
Falsify and issue bounded validation status |
physics/curriculum-evolve |
physics.curriculum-evolution |
Generate clean-room frontier experiments and problems |
physics/safety-gate |
physics.safety-governance |
Gate hazardous and dual-use procedural detail |
physics/historian-compare |
physics.historian |
Post-freeze equivalence and novelty analysis |
Non-negotiable separation
- The modern
referenceindex must be inaccessible to the learner. - Simulator truth and evaluator internals must be inaccessible to the learner.
- A validator must not be the candidate generator.
- A promotion owner must not waive failed hard gates through utility scoring.
- A historian operates only after generation freeze.
- Safety and epistemic judgments remain separate artifacts.
- Rejected artifacts are retained for falsifier and curriculum learning, not trusted positive knowledge.
Recommended rollout
- Add native schemas and the compatibility wrapper.
- Add partition-scoped storage and retrieval before any clean-room experiment.
- Implement quantity normalization, model formalization, experiment design, simulation assessment, safety, falsification, and validation capabilities.
- Ingest the first twelve reference modules.
- Build and freeze Physica-0 worlds, seeds, and hidden evaluation maps.
- Run learner generations with complete session and retrieval traces.
- Add training-record generation only from policy-eligible frozen artifacts.
- Publish documentation after LMeta/LCDL identity parity and release checks pass.