3.6 KiB
Lardon3D — Final Execution Contract
This file is the entry point for the collective Lardon3D execution contract.
CONTRACT_SCOPE=ENTIRE_PROMPT_TREE
CONTRACT_LANGUAGE=ENGLISH
WORK_FIRST_RETURN_LAST=REQUIRED
CANONICAL_WORKING_BRANCH=main
CURRENT_STATE_AUTHORITY=main
GIT_CLOSURE_OWNER=HUMAN
IMPLEMENTATION_AUTHORIZATION=NO
Mandatory reading order
Before any major implementation tranche, read:
AGENTS.mdREADME.mddocs/README.mddocs/product/product_definition.mddocs/roadmap/roadmap.md- every file under
prompt/in numeric order from00_AUTHORITY.mdthrough33_DEFINITION_OF_DONE.md - the specialized canonical
docs/architecture/**documents cited by the tranche
The files under prompt/ form one collective contract. No child file may be interpreted in isolation when another child file defines a complementary constraint.
Absolute rules
- Preserve all applicable PASS/FROZEN scientific and architectural boundaries.
- Never invent calibration, lens identity, metric scale, campaign equivalence, provenance, or scientific identity.
- Never create a Project DB version or production Task Kind without explicit human authorization.
- Never create a second Task Runtime, Queue, scheduler, Resource Governor, generic executor, or backend framework merely for convenience.
- Never modify
scan3d/without explicit human authorization. - Never use retained real scientific projects as destructive scratch/test workspaces.
- Never reinterpret historical checkpoints as current state.
- Never treat GitHub and Forgejo as different project authorities; they are mirrors of the same canonical
main. - Never stage with
git add -A. - Never commit or push unless the human explicitly authorizes Git closure.
- Never force-push unless the human explicitly authorizes that exact operation.
STOP
STOP before any change that would:
- reopen a PASS/FROZEN boundary;
- change a FROZEN scientific threshold or identity;
- introduce pseudo-calibration or silent calibration substitution;
- introduce an unauthorized Project DB schema version;
- introduce an unauthorized production Task Kind;
- create an unnecessary parallel runtime/scheduler/backend framework;
- modify
scan3d/; - perform a destructive operation;
- create/switch/merge/rebase branches without authorization;
- resolve an unexplained mirror divergence by overwriting one remote;
- contradict executable code/schema and a canonical contract;
- resolve a material product ambiguity by assumption.
A STOP report contains only the relevant authority, the exact contradiction, and the minimum human decision required.
Execution discipline
For an authorized tranche:
- identify the governing authority;
- inspect only the context needed to execute correctly;
- define the exact file and subsystem scope;
- implement the complete tranche;
- run proportional delta-based validation;
- fix defects within scope;
- run
git diff --check; - report only after the tranche is complete or a real STOP condition is reached.
Do not return after each file. Do not repeat global A-to-Z audits when unchanged FROZEN systems already have retained evidence.
Current head assumptions
This contract was prepared against the repository state that declares:
CURRENT_PROJECT_DB_SCHEMA=v25
PRODUCTION_TASK_KINDS=16
PRODUCT_DEFINITION_V1=PASS/FROZEN
PROMPT_TREE=NEXT
REAL_S21_TRACKS=PASS/FROZEN
REAL_A6000_PRE_SFM=PASS/FROZEN
Before implementation, verify these assumptions against current main. If current main has legitimately advanced, update only the CURRENT statements that are stale; never rewrite historical or FROZEN meaning silently.