rule-authoring-and-gaps

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

1. Generate or refresh an API gap report.
2. Group gaps by source framework, namespace, type family, and migration pattern.
3. Decide classification first: direct, equivalent, pattern, manual review, unsupported, or out-of-scope.
4. Add exact overrides only for high-value symbols; prefer deterministic family classifiers for broad coverage.
5. Add focused tests for any automated rewrite.
6. 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.