24 lines
974 B
Markdown
24 lines
974 B
Markdown
|
# Triage & Preflight
|
||
|
|
|
||
|
|
## Preflight Checks
|
||
|
|
|
||
|
|
Before executing workflow commands:
|
||
|
|
|
||
|
|
1. Confirm working directory is repository root.
|
||
|
|
2. Run `vlm --help`; if unavailable, switch to `uv run vlm`.
|
||
|
|
3. Run `<subcommand> --help` when options are uncertain.
|
||
|
|
4. Run `vlm config validate` after config edits.
|
||
|
|
5. Verify required input files exist before downstream stages.
|
||
|
|
6. Treat `execute --confirm` as destructive; require explicit user confirmation.
|
||
|
|
|
||
|
|
## Failure Triage
|
||
|
|
|
||
|
|
| Problem | Command |
|
||
|
|
|---------|---------|
|
||
|
|
| Missing config | `vlm config init`, then set `library_root` |
|
||
|
|
| Invalid config values | `vlm config validate` and fix reported keys |
|
||
|
|
| Missing input artifact | Run prerequisite stage (scan → parse → analyze → plan) |
|
||
|
|
| Unexpected duplicate decisions | Check `plan.duplicate_keep` in config, rerun `vlm plan --analysis` |
|
||
|
|
| Unsafe execution results | `vlm rollback`, inspect plan, re-run `execute --confirm` |
|
||
|
|
| `vlm` not found | Use `uv run vlm ...` fallback |
|