Extract Serena language server documentation to separate reference file

[Copilot]

Serena is an advanced static analysis tool intended only for complex coding tasks requiring semantic analysis. The inline documentation was promoting it as a general-purpose tool, leading to inappropriate usage in simple workflows.

Changes

Created .github/aw/serena-tool.md

• Positions Serena as advanced-only tool requiring explicit user request
• Documents appropriate use cases (deep refactoring, cross-file analysis, type inference)
• Documents inappropriate use cases (simple edits, basic generation, general automation)
• Provides configuration examples and language detection patterns

Updated workflow templates

• .github/aw/create-agentic-workflow.md
• .github/aw/update-agentic-workflow.md
• pkg/cli/templates/create-agentic-workflow.md
• pkg/cli/templates/update-agentic-workflow.md

Replaced inline Serena configuration examples with reference to centralized documentation:

- **Advanced static analysis** → See `.github/aw/serena-tool.md` for guidance on when and how to use Serena language server (only for advanced coding tasks when user explicitly requests it)

Integrated serena-tool.md into compiler template system

• Added serena-tool.md to embedded templates in pkg/cli/commands.go
• Created ensureSerenaTool() function in pkg/cli/copilot-agents.go
• Integrated into init.go, upgrade_command.go, and fix_command.go
• File is automatically created/updated in users' .github/aw/ folder during gh aw init, gh aw upgrade, and gh aw fix commands

Impact

Agents will now ask users before adding Serena to workflows rather than suggesting it by default for any code analysis task. Centralizes maintenance of Serena documentation in single file. The documentation is automatically distributed to users through the CLI, ensuring they always have access to the latest guidance without manual intervention.

Original prompt

Remove the Serena related prompts to a separate file in .github/aw/ from the create-agentic-workflow/update-agentic-workflow.md files. Serena is an advanced static analysis tool only suitable for advanced coding tasks. If the user explicitely asks for advanced static analysis for specific languages, suggest the Serena tool.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[pelikhan]

Add file to compiler and save to user aw folder @copilot

Like create-agentic-workflow

[Copilot]

Add file to compiler and save to user aw folder @copilot

Like create-agentic-workflow

Done! Added serena-tool.md to the compiler template system. The file will now be automatically created/updated in users' .github/aw/ folder during gh aw init, gh aw upgrade, and gh aw fix commands, following the same pattern as create-agentic-workflow.md.

Changes in commit 1824ab2:

• Embedded template in pkg/cli/commands.go
• Added ensureSerenaTool() function in pkg/cli/copilot-agents.go
• Integrated into init.go, upgrade_command.go, and fix_command.go