KOKO\Mimi
97 lines
4.3 KiB
Markdown
97 lines
4.3 KiB
Markdown
# Step 12: execution-closure-and-evidence-docs
|
|
|
|
## 읽어야 할 파일
|
|
|
|
- `AGENTS.md`
|
|
- `docs/PRD.md`
|
|
- `docs/ARCHITECTURE.md`
|
|
- `docs/ADR.md`
|
|
- `docs/CODINGSTYLE.md`
|
|
- `docs/TOLERANCE.md`
|
|
- `docs/nonlinear-static-newton-raphson/implementation-plan.md`
|
|
- `docs/nonlinear-static-newton-raphson/requirements.md`
|
|
- `docs/nonlinear-static-newton-raphson/numerical-review.md`
|
|
- `docs/nonlinear-static-newton-raphson/reference-model.md`
|
|
- `docs/nonlinear-static-newton-raphson/io.md`
|
|
- `phases/nonlinear-static-newton-raphson/index.json`
|
|
- Step 0-11 modified source/test/CMake files
|
|
|
|
## 이전 Step 전제
|
|
|
|
Steps 0-11 have implemented and verified CLI lifecycle, Domain contract, nonlinear MITC4, controls, tangent solver, log, state, HDF5 schema v1, full prepared procedure, and reference comparison tests.
|
|
|
|
## 소유 파일
|
|
|
|
- Modify: `docs/PRD.md`
|
|
- Modify: `docs/ARCHITECTURE.md`
|
|
- Modify: `docs/ADR.md`
|
|
- Create: `docs/nonlinear-static-newton-raphson/implementation-report.md`
|
|
- Create: `docs/nonlinear-static-newton-raphson/build-test.md`
|
|
- Create: `docs/nonlinear-static-newton-raphson/reference-comparison.md`
|
|
|
|
No C++ production file is owned by this Step.
|
|
|
|
## 인터페이스
|
|
|
|
Evidence documents must record actual observed outputs:
|
|
|
|
```text
|
|
implementation-report.md: RED/GREEN/VERIFY command log, Step summaries, diagnostics, implementation-owned decisions.
|
|
build-test.md: fresh configure/build/discovery/full CTest commands, exit codes, duration, stdout/stderr tail, warning audit, failure classification.
|
|
reference-comparison.md: exact artifact inventory, HDF5 paths, projection, row prechecks, tolerance, per-family decisions, classification, no-change assertion.
|
|
```
|
|
|
|
## RED
|
|
|
|
Before writing evidence docs, run an evidence freshness audit by checking that the three evidence docs do not already contain current command outputs from this final Step.
|
|
|
|
- `NSNR-EVID-001`: missing or stale `implementation-report.md` is a failing precondition.
|
|
- `NSNR-EVID-002`: missing or stale `build-test.md` is a failing precondition.
|
|
- `NSNR-EVID-003`: missing or stale `reference-comparison.md` is a failing precondition.
|
|
- `NSNR-EVID-004`: PRD/ARCHITECTURE/ADR still contain directly superseded global CLI/procedure/output statements.
|
|
- `NSNR-EVID-005`: reference artifact pre-run SHA inventory must match Step 11 values.
|
|
|
|
Expected: evidence freshness audit fails before this Step writes docs. If it unexpectedly passes with current evidence already present, stop and report to Coordinator.
|
|
|
|
## GREEN
|
|
|
|
- Run fresh MSVC x64 Debug configure/build/discovery/full CTest.
|
|
- Run focused nonlinear reference comparison repeat.
|
|
- Run deterministic repeat/reference checks required by Step 11.
|
|
- Run warning audit from build output.
|
|
- Run `git diff --check` and `git status --short`.
|
|
- Run reference artifact post-run SHA audit and compare to pre-run values.
|
|
- Update only directly superseded PRD/ARCHITECTURE/ADR statements for CLI removal, prepared linear/nonlinear procedure boundary, output naming, log lifecycle, and nonlinear HDF5 schema.
|
|
- Create the three Stage 6 evidence docs from actual command outputs only.
|
|
|
|
## VERIFY
|
|
|
|
Recheck `.harness/config.json`. If absent, use:
|
|
|
|
```powershell
|
|
cmake --fresh -S . -B .harness/build -G "Visual Studio 18 2026" -A x64 `
|
|
"-DFESA_GTEST_SOURCE_DIR=$gtestSource" `
|
|
"-DMKL_DIR=$mklDir" `
|
|
"-DTBB_DIR=$tbbDir" `
|
|
"-DHDF5_DIR=$hdf5Dir"
|
|
cmake --build .harness/build --config Debug
|
|
ctest --test-dir .harness/build -C Debug --show-only=json-v1
|
|
ctest --test-dir .harness/build -C Debug --output-on-failure
|
|
ctest --test-dir .harness/build -C Debug -R "NonlinearStaticReference" --output-on-failure
|
|
git diff --check
|
|
git status --short
|
|
```
|
|
|
|
Record command, exit code, duration, stdout/stderr tail, and failure classification for every command in the evidence docs.
|
|
|
|
## 상태 기록
|
|
|
|
Update only Step 12 status and one-line payload. Executor owns timestamps, commits, retry, top-level phase completion, and advancement.
|
|
|
|
## 금지사항
|
|
|
|
- Do not claim success before the commands above actually pass. 이유: Stage 6 evidence docs must be output-backed.
|
|
- Do not broadly rewrite global docs. 이유: Step 12 only synchronizes directly superseded CLI/procedure/output statements.
|
|
- Do not change reference artifact content. 이유: SHA pre/post immutability is part of the acceptance evidence.
|
|
- Do not run `scripts/execute.py` from this Step. 이유: Executor already owns Harness execution.
|