[Docs]: Audit or retire deprecated backend migrations reference

[Fermionic-Lyu]

Summary

skills/insforge-cli/references/db-migrations.md should be explicitly audited as part of the cleanup pass. It is a substantial backend migration guide and is still linked from multiple skills. If this migration reference is deprecated, it needs either removal/redirection or an updated replacement path; if it is still canonical, the deprecation ambiguity should be resolved and the file should be refreshed.

Validation

Partially valid. The repo does not mark the file as deprecated, but the candidate file exists, is sizeable, and is referenced from the CLI/debug skill surface. Because maintainers have flagged a deprecated backend migration MD concern during cleanup, this should be tracked explicitly.

Relevant Code

• skills/insforge-cli/references/db-migrations.md:1 through skills/insforge-cli/references/db-migrations.md:214 - standalone migration reference.
• skills/insforge-cli/SKILL.md:87 - links to references/db-migrations.md.
• skills/insforge-cli/SKILL.md:289 through skills/insforge-cli/SKILL.md:295 - repeats migration behavior in the main skill body.
• skills/insforge-cli/SKILL.md:328 through skills/insforge-cli/SKILL.md:364 - includes two migration workflow sections in the main skill body.
• skills/insforge-cli/references/db-query.md:55 and skills/insforge-cli/references/db-query.md:86 - points users from db query to the migrations workflow.
• skills/insforge-debug/references/policies.md:51 - points policy/RLS troubleshooting to the migrations reference.

Proposed Solution

Decide the intended status of backend migration guidance:

• If deprecated, replace links with the current migration/config workflow and remove or archive db-migrations.md.
• If still canonical, remove ambiguity by refreshing it and trimming duplicate migration workflow blocks from skills/insforge-cli/SKILL.md.
• If both old and new flows exist, add a clear version gate so agents choose the right path.

Acceptance Criteria

• Maintainers can tell whether db-migrations.md is canonical, deprecated, or version-gated.
• No skill links point agents to deprecated migration guidance without a warning.
• Duplicated migration guidance in the main CLI skill and reference file is reduced or intentionally cross-linked.