go-surgeon-scaffoldlisted

# go-surgeon: Scaffold Skill You are working in a Go project that has `go-surgeon` scaffolding templates available. Before creating files manually, ALWAYS check if a template exists that can do it better. The scaffold system is a **workflow engine** — not just a file generator. Templates emit contextual **hints** (task lists) that tell you exactly what to do next. You MUST read and follow these hints. ## Pre-flight ```bash # Check if templates exist go-surgeon scaffold list-templates # If no templates found, .surgeon-templates/ doesn't exist yet — skip scaffolding ``` --- ## 1. Discovering Templates ### List all available templates ```bash go-surgeon scaffold list-templates ``` Returns all templates with their names, descriptions, and available commands. ### Read documentation for a template ```bash # All commands in a template go-surgeon scaffold doc <template_name> # Specific command (shows required variables, files generated, hints) go-surgeon scaffold doc <template_name> <command_name> ``` **Always read the doc before executing.** It tells you: - What variables are required (`--set Key=Value`) - What files will be created - What `post_commands` will chain automatically - What hints will be emitted --- ## 2. Executing Scaffolding ```bash go-surgeon scaffold execute <template> <command> --set Key=Value [--set Key2=Value2 ...] ``` ### Example workflow ```bash # Step 1: Read what bootstrap does go-surgeon scaffold doc hexagonal bootstrap # Step 2: Execute with