anthony.wen/cds-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Clarify ATVM automation examples are reference-only

Browse Source 
- Treat atvm-automation-examples.md as reference material rather than default operator intent.

- Use only explicitly requested options, plus maintained mandatory blacklist handling.

- Record the rule as a run learning in atvm-automation-runs.md.
This commit is contained in:
anthony.wen
2026-03-12 17:02:49 -04:00
parent bb7275db4a
commit 63fc92244e
3 changed files with 14 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
atvm/AGENTS.md
View File

@@ -76,6 +76,8 @@ Use `atvm-setup-script-guide.md` as the procedure source and keep behavior align
## Cypress Automation Track: Required Behavior ## Cypress Automation Track: Required Behavior
Use `atvm-automation-guide.md` as the execution source. Use `atvm-automation-guide.md` as the execution source.
Use `atvm-automation-examples.md` as the common options/command reference. Use `atvm-automation-examples.md` as the common options/command reference.
Treat `atvm-automation-examples.md` as reference-only.
Do not treat example options, excludes, plugins, or filters as default operator intent unless the operator explicitly asks for them.
### Controller Client ### Controller Client
- Hostname: `atvm-cypres-vm-1` - Hostname: `atvm-cypres-vm-1`

3
atvm/atvm-automation-guide.md
View File

@@ -3,6 +3,8 @@
This file is guide-only documentation for operating ATVM CMC automation. This file is guide-only documentation for operating ATVM CMC automation.
Do not put specific run examples here. Do not put specific run examples here.
For reusable command examples and common option combinations, use `atvm-automation-examples.md`. For reusable command examples and common option combinations, use `atvm-automation-examples.md`.
Treat `atvm-automation-examples.md` as reference-only.
Do not assume the operator wants the extra options shown in examples unless they explicitly request them.
## Purpose ## Purpose
Run ATVM CMC automation tests on the designated automation VM without unintended system or file changes. Run ATVM CMC automation tests on the designated automation VM without unintended system or file changes.
@@ -67,6 +69,7 @@ python3 ./run-sorry-cypress.py --config_file <config-file> --build_name <hyphena
## Examples Reference ## Examples Reference
- Commonly used command examples: `atvm-automation-examples.md` - Commonly used command examples: `atvm-automation-examples.md`
- Keep this guide focused on run-control rules and workflow constraints. - Keep this guide focused on run-control rules and workflow constraints.
- Use examples as reference material only, not as default intent for new operator requests.
## Example Option Patterns (Guide-Only) ## Example Option Patterns (Guide-Only)
- Distro-scoped VM selection: - Distro-scoped VM selection:

9
atvm/atvm-automation-runs.md
View File

@@ -99,3 +99,12 @@ This file stores run-specific examples only when a run produced a new learning r
- Action for future runs: - Action for future runs:
- Do not reference `cypress.atvm-config.ts` by default in commands or examples. - Do not reference `cypress.atvm-config.ts` by default in commands or examples.
- Default to `cypress.atvm-config-gold.ts` unless the operator explicitly requests another config. - Default to `cypress.atvm-config-gold.ts` unless the operator explicitly requests another config.
## Run Learning: 2026-03-12 (Examples are reference-only, not default intent)
- Observed requirement:
- Reusable examples may contain extra excludes or options that the operator did not ask for.
- Carrying those example details into a new run without confirmation can change the requested scope.
- Action for future runs:
- Treat `atvm-automation-examples.md` as reference-only.
- Use only the options the operator explicitly requested, plus maintained mandatory blacklist handling.
- Do not assume extra example exclusions such as distro filters are desired unless the operator asks for them.