| name | rule-authoring-and-gaps |
| description | Use when creating, extending, or reviewing AW2U/WP2U migration rules, rule packs, API gap classifications, or diagnostics. |
Rule Authoring And Gaps
Use this skill to add migration rules or classify uncovered APIs.
Inputs
specs/001-migration-core/rule-family-catalog.md
specs/001-migration-core/api-surface/classifications/
rulepacks/
- API gap reports from
api gaps
Workflow
- Generate or refresh an API gap report.
- Group gaps by source framework, namespace, type family, and migration pattern.
- Decide classification first: direct, equivalent, pattern, manual review, unsupported, or out-of-scope.
- Add exact overrides only for high-value symbols; prefer deterministic family classifiers for broad coverage.
- Add focused tests for any automated rewrite.
- Re-run
api coverage and relevant golden tests.
Rule Safety
Safe: deterministic text/AST rewrite with strong preconditions and tests.
Review: rewrite can be previewed but requires human confirmation.
Manual: diagnostic/report only.
Never increase automation coverage by hiding unknowns as unsupported without rationale.