Skip to content

Commit 41cee1f

Browse files
committed
Clarify clean validation for stale artifacts
1 parent 33fb3d8 commit 41cee1f

2 files changed

Lines changed: 5 additions & 3 deletions

File tree

.github/instructions/build.instructions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ Re-run the scripted build:
7171
If the failure persists, check the first error (later ones often cascade) and confirm native Phase 2 succeeds.
7272

7373
### Stale intermediates
74-
Prefer re-running `.\build.ps1` first (it performs cleanup needed for this repo). If you must do a hard reset, delete `Output/` and `Obj/`, then run `.\build.ps1` again.
74+
Prefer `.\build.ps1 -Clean` when switching branches or worktrees, after package or version bumps, when stale `Obj/` or `Output/` artifacts are plausible, or when you need a completely clean validation run. If you must do a harder reset beyond that, delete `Output/` and `Obj/`, then run `.\build.ps1` again.
7575

7676
## References
7777
- Traversal order: `FieldWorks.proj`

.github/skills/verify-test/SKILL.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,17 +18,19 @@ You will receive:
1818
<workflow>
1919
1. **Select verification steps**
2020
- Choose the minimal tests or checks that validate acceptance signals.
21+
- If stale intermediates or copied outputs could invalidate the result, include a clean validation pass.
2122
2. **Run verification**
2223
- Execute builds/tests or manual checks as appropriate.
24+
- For FieldWorks, run `./build.ps1 -Clean` before validation when switching branches or worktrees, upgrading package versions, suspecting stale `Obj/` or `Output/` artifacts, or any time you need a fully clean validation baseline.
25+
- After the clean step, rerun the normal scripted verification commands such as `./build.ps1`, `./test.ps1`, or the narrow scripted slice you are validating.
2326
3. **Capture results**
2427
- Record pass/fail outcomes and any artifacts.
2528
4. **Report**
2629
- Summarize verification coverage and gaps.
2730
</workflow>
2831

2932
<constraints>
30-
- Prefer repo-standard build/test entry points.
31-
- Document any skipped verification and why.
33+
- In FieldWorks, do not rely on incremental validation alone when stale native or managed artifacts are plausible.
3234
</constraints>
3335

3436
<notes>

0 commit comments

Comments
 (0)