What problem does it solve?
This Skill prevents broken or subtly incorrect scaffolds when porting an existing Go codebase into a Forge-generated project structure, by guiding the required pre-flight checks and a safe porting order. It also reduces time wasted on environment/tooling mismatches and common migration footguns that only surface after codegen or runtime failures.
Core Features & Use Cases
- Pre-flight readiness checks: verifies tool availability and environment visibility so Forge subprocess codegen behaves deterministically.
- Project-shape and module-path strategy: helps you choose the correct
service, cli, or library scaffold shape and plan a safe -next cutover module strategy.
- Deterministic porting and verification loop: recommends an incremental migration order with repeated
forge generate, go mod tidy, go build, and forge lint, including an early contracts floor and per-phase contract linting.
Quick Start
Follow the migration pre-flight checklist, scaffold a <name>-next project with the correct --kind and --mod, then port internal packages first while running forge generate and lint after each component addition until you reach a clean build baseline.