Reproduction Boundary Governance
Core Rule
Before implementation or full runs, verify whether the reproduction target is still the same task, method, data contract, and evaluation protocol as the source work. Do not treat runnable code as sufficient evidence of faithful reproduction.
Required Intake
Collect or infer these items before coding:
- Original task, prediction target, sample unit, and input/output format.
- Required data modalities, graph structure, auxiliary features, and preprocessing.
- Core method components and which ones are essential versus optional.
- Train/validation/test split, horizon, metrics, seeds, and reporting protocol.
- Available local data, code, compute limits, and missing prerequisites.
Alignment Table
Create a compact table before implementation:
| Boundary |
Source requirement |
Local implementation |
Status |
Action |
| Task |
|
|
aligned / mismatch / unknown |
|
| Target |
|
|
aligned / mismatch / unknown |
|
| Sample unit |
|
|
aligned / mismatch / unknown |
|
| Inputs |
|
|
aligned / mismatch / unknown |
|
| Core modules |
|
|
aligned / mismatch / unknown |
|
| Evaluation |
|
|
aligned / mismatch / unknown |
|
Classification
Assign exactly one result category before comparing metrics:
faithful: task, target, inputs, core modules, and evaluation are aligned.
adaptation: task, target, data contract, or sample unit changes, but the method idea is intentionally preserved.
ablation: a known component is removed or isolated to measure its effect.
diagnostic: implementation exists only to inspect behavior or validate assumptions.
excluded: required inputs, task setting, or core assumptions are unavailable or incompatible.
Adaptation Approval Gate
Any adaptive implementation requires explicit user approval before coding, training, or launching long runs. This includes replacing targets, vertices, modalities, auxiliary data, distributed settings, official code, or unavailable inputs.
Use this proposal template:
## Adaptation Proposal
Original method:
Original task:
Original prediction target:
Original sample unit / graph vertex:
Original required inputs:
Original core components:
Broken boundary:
Why faithful reproduction is not possible:
Proposed adaptation:
New task:
New prediction target:
New sample unit / graph vertex:
Inputs to be used:
Components preserved:
Components removed or replaced:
New method name:
Result category:
Expected risk:
User approval required before implementation: yes
Naming Rules
- Use the original method name only for
faithful reproduction.
- Use
Method-Adapted when the task or data contract changes.
- Use
Method-TargetName when the prediction target or sample unit changes.
- Use
Method-w/o-X when a component is intentionally removed.
- Use
Method-Inspired when only the high-level idea remains.
- Avoid exposing internal labels such as
core, lite, proxy, or fallback in final tables.
Long-Run Gate
Do not start full or expensive runs until all are true:
- Alignment table and classification are recorded.
- Method name and result category are fixed.
- No unapproved adaptation or fallback remains.
- Smoke run covers data loading, forward pass, backward pass, validation, and metric logging.
- Split, horizon, normalization, seed, metric definitions, run command, and code version are captured.
Manifest Requirements
Record for every reproduced method:
- method name, category, source reference, and implementation source.
- task, target, sample unit, inputs, outputs, and graph/data assumptions.
- implemented components, omitted components, replacements, and deviations.
- split, horizon, metrics, seed, command, code version, timestamp, and hardware.
- approval record for every adaptation.
Result Reporting
Keep faithful reproductions, adapted baselines, ablations, diagnostics, and excluded methods in separate sections. Do not rank adapted or diagnostic results as if they were faithful baselines. For excluded methods, state the missing boundary and why self-implementation or substitution would no longer be faithful.
Agent Workflow
- Read the source paper or official implementation enough to identify boundaries.
- Inspect local data and existing code before proposing implementation.
- Build the alignment table and classification.
- Ask the user only for true boundary decisions that cannot be inferred.
- Implement only after boundaries and approvals are fixed.
- Smoke test before long runs.
- Update memory or project notes with deviations, approvals, and final category.
1---2name: reproduction-boundary-governance3description: Enforce strict task, data, method, and evaluation boundary checks for paper or model reproduction before implementation or long runs. Use when reproducing papers, adapting methods to available data, classifying faithful versus adapted baselines, or requiring explicit user approval for any adaptive implementation.4---56# Reproduction Boundary Governance78## Core Rule910Before implementation or full runs, verify whether the reproduction target is still the same task, method, data contract, and evaluation protocol as the source work. Do not treat runnable code as sufficient evidence of faithful reproduction.1112## Required Intake1314Collect or infer these items before coding:1516- Original task, prediction target, sample unit, and input/output format.17- Required data modalities, graph structure, auxiliary features, and preprocessing.18- Core method components and which ones are essential versus optional.19- Train/validation/test split, horizon, metrics, seeds, and reporting protocol.20- Available local data, code, compute limits, and missing prerequisites.2122## Alignment Table2324Create a compact table before implementation:2526| Boundary | Source requirement | Local implementation | Status | Action |27| --- | --- | --- | --- | --- |28| Task | | | aligned / mismatch / unknown | |29| Target | | | aligned / mismatch / unknown | |30| Sample unit | | | aligned / mismatch / unknown | |31| Inputs | | | aligned / mismatch / unknown | |32| Core modules | | | aligned / mismatch / unknown | |33| Evaluation | | | aligned / mismatch / unknown | |3435## Classification3637Assign exactly one result category before comparing metrics:3839- `faithful`: task, target, inputs, core modules, and evaluation are aligned.40- `adaptation`: task, target, data contract, or sample unit changes, but the method idea is intentionally preserved.41- `ablation`: a known component is removed or isolated to measure its effect.42- `diagnostic`: implementation exists only to inspect behavior or validate assumptions.43- `excluded`: required inputs, task setting, or core assumptions are unavailable or incompatible.4445## Adaptation Approval Gate4647Any adaptive implementation requires explicit user approval before coding, training, or launching long runs. This includes replacing targets, vertices, modalities, auxiliary data, distributed settings, official code, or unavailable inputs.4849Use this proposal template:5051```md52## Adaptation Proposal5354Original method:55Original task:56Original prediction target:57Original sample unit / graph vertex:58Original required inputs:59Original core components:6061Broken boundary:62Why faithful reproduction is not possible:6364Proposed adaptation:65New task:66New prediction target:67New sample unit / graph vertex:68Inputs to be used:69Components preserved:70Components removed or replaced:71New method name:72Result category:73Expected risk:7475User approval required before implementation: yes76```7778## Naming Rules7980- Use the original method name only for `faithful` reproduction.81- Use `Method-Adapted` when the task or data contract changes.82- Use `Method-TargetName` when the prediction target or sample unit changes.83- Use `Method-w/o-X` when a component is intentionally removed.84- Use `Method-Inspired` when only the high-level idea remains.85- Avoid exposing internal labels such as `core`, `lite`, `proxy`, or `fallback` in final tables.8687## Long-Run Gate8889Do not start full or expensive runs until all are true:9091- Alignment table and classification are recorded.92- Method name and result category are fixed.93- No unapproved adaptation or fallback remains.94- Smoke run covers data loading, forward pass, backward pass, validation, and metric logging.95- Split, horizon, normalization, seed, metric definitions, run command, and code version are captured.9697## Manifest Requirements9899Record for every reproduced method:100101- method name, category, source reference, and implementation source.102- task, target, sample unit, inputs, outputs, and graph/data assumptions.103- implemented components, omitted components, replacements, and deviations.104- split, horizon, metrics, seed, command, code version, timestamp, and hardware.105- approval record for every adaptation.106107## Result Reporting108109Keep faithful reproductions, adapted baselines, ablations, diagnostics, and excluded methods in separate sections. Do not rank adapted or diagnostic results as if they were faithful baselines. For excluded methods, state the missing boundary and why self-implementation or substitution would no longer be faithful.110111## Agent Workflow1121131. Read the source paper or official implementation enough to identify boundaries.1142. Inspect local data and existing code before proposing implementation.1153. Build the alignment table and classification.1164. Ask the user only for true boundary decisions that cannot be inferred.1175. Implement only after boundaries and approvals are fixed.1186. Smoke test before long runs.1197. Update memory or project notes with deviations, approvals, and final category.