local-dev-workflow

What problem does it solve?

This Skill standardizes the creation of a reliable local development startup script (start.sh) to ensure port isolation, deterministic re-runs, and a clear runtime dashboard, helping teams avoid common environment-start failures.

Core Features & Use Cases

• Port sovereignty: assigns unique, non-conflicting ports per project to prevent clashes with other running apps.
• Idempotent startup: the script can be re-run safely; it searches for and terminates processes occupying configured ports before launching.
• Transparent dashboard: after startup, outputs running services, PIDs, and accessible URLs for quick verification.
• One-Click startup: orchestrates Docker (when present), backend, frontend, and environment setup with a single script.
• Template-driven: provides a canonical start.sh pattern and references a shared template in resources/start-script-template.md for adaptation.

Quick Start

Generate a start.sh that follows the Standard start.sh Template in resources/start-script-template.md, place it at your project root, make it executable, and run ./start.sh.