| name | awa-upgrade |
| description | Upgrade specs to match current schemas. Use this when asked to upgrade, migrate, or update specification documents to conform to schema changes. |
Upgrade Specs to Current Schemas
Bootstrap
User Input
${input}
You MUST consider the user input before proceeding (if not empty).
Inputs
Action
Upgrade the specified specs to conform to their schemas and traceability rules.
- ORIENT: Confirm which artifacts to upgrade; clarify missing targets.
- CHECK: Run
awa check in the terminal to identify schema violations and traceability errors across all target files. Parse the output to build a list of findings to fix.
- FIX: For each reported error, edit the file to resolve the violation — fix section structure, heading levels, missing required content, prohibited patterns, and broken trace IDs.
- RECHECK: Run
awa check again to verify all errors are resolved. Repeat FIX → RECHECK until the check passes cleanly (warnings and info findings are acceptable).
- REPORT: Summarize changes and remaining questions before finalizing.
Outputs
- Updated spec(s) and supporting templates (as applicable)
Rules
You SHALL avoid destructive edits; propose clarifications when unsure.
You SHALL follow schema structure strictly (section order, nesting).
You SHALL obey schema render expectations (omit optional empty sections, avoid prohibited patterns).
You SHALL upgrade existing trace IDs if necessary.
You SHALL upgrade existing filenames if necessary.
You SHALL respect the file line-limits; split logically if needed.
You MAY use todos and tools as needed.
