NINI
76 lines
3.0 KiB
Markdown
76 lines
3.0 KiB
Markdown
# Step 15: phase1-evaluator-closeout
|
|
|
|
## Sprint Contract
|
|
|
|
### Objective
|
|
Run the full Phase 1 evaluator pass, close documentation and handoff gaps, and record Phase 2 carryovers.
|
|
|
|
### Required Reading
|
|
- /AGENTS.md
|
|
- /PROGRESS.md
|
|
- /PLAN.md
|
|
- /docs/README.md
|
|
- /docs/HARNESS_ENGINEERING.md
|
|
- /docs/PRD.md
|
|
- /docs/ARCHITECTURE.md
|
|
- /docs/ADR.md
|
|
- /docs/NUMERICAL_CONVENTIONS.md
|
|
- /docs/ABAQUS_INPUT_SUBSET.md
|
|
- /docs/VERIFICATION_PLAN.md
|
|
- /docs/RESULTS_SCHEMA.md
|
|
- /docs/MITC4_FORMULATION.md
|
|
- /references/README.md
|
|
- /phases/1-linear-static-mitc4/index.json
|
|
|
|
### Scope
|
|
- Evaluate all Phase 1 Definition of Done items from `PLAN.md` and `docs/PRD.md`.
|
|
- Run the full validation command set and inspect reference-comparison evidence.
|
|
- Produce a concise evaluator report in `PROGRESS.md` or a linked docs artifact.
|
|
- Move unresolved Phase 2 or deferred work into `PLAN.md`.
|
|
|
|
### Allowed Files
|
|
- `docs/**`
|
|
- `tests/**` only for evaluator-owned missing validation metadata, not feature implementation
|
|
- `references/**` only for documentation or final accepted artifact notes
|
|
- `PLAN.md`
|
|
- `PROGRESS.md`
|
|
- `phases/1-linear-static-mitc4/index.json`
|
|
|
|
### Explicit Non-Goals
|
|
- Do not implement missing solver features in the evaluator step.
|
|
- Do not mark Phase 1 complete if validation, reference comparison, MITC4 formulation, RF recovery, or parser rejection evidence is missing.
|
|
- Do not hide remaining risks in prose without putting future tasks in `PLAN.md`.
|
|
|
|
### Tests To Write First
|
|
- No new implementation tests are expected unless the evaluator identifies missing metadata tests that are needed to prove acceptance.
|
|
|
|
### Reference Artifacts
|
|
- Required: all accepted Phase 1-compatible reference cases and their `*_displacements.csv` files.
|
|
- Optional: `*_reactions.csv`; otherwise evaluator must verify RF through internal equilibrium tests.
|
|
|
|
### Acceptance Commands
|
|
```bash
|
|
python scripts/validate_workspace.py
|
|
```
|
|
|
|
### Evaluator Checklist
|
|
- Phase 1 Definition of Done is checked item by item.
|
|
- Parser rejects unsupported Abaqus features with tests.
|
|
- MITC4 baseline tests and documented formulation agree.
|
|
- `U` reference comparison evidence exists for accepted cases.
|
|
- `RF` is recovered from full vectors and verified by available reference or equilibrium tests.
|
|
- `PLAN.md` and `PROGRESS.md` are current.
|
|
|
|
### Handoff Requirements
|
|
- Record final verdict, validation output, reference evidence, and remaining risks in `PROGRESS.md`.
|
|
- Move future work, Phase 2 candidates, and deferred features into `PLAN.md`.
|
|
- Update the matching phase index entry: use `completed` with a one-line `summary`, or `blocked` with `blocked_reason`, or `error` with `error_message`; update the top-level phase status if execution is complete.
|
|
|
|
## Verification
|
|
1. Run the acceptance command.
|
|
2. Perform the evaluator checklist against changed files and test evidence.
|
|
3. Confirm no phase step remains with stale status or missing handoff notes.
|
|
|
|
## Do Not
|
|
- Do not use evaluator closeout as a place to sneak in broad implementation fixes.
|