Add --agents-file flag to bd init allowing users to specify a custom
filename for agent instructions (default remains AGENTS.md). This
addresses the use case where projects prefer different naming
conventions (e.g. BEADS.md) without requiring a post-init rename.
Changes:
- Add config.AgentsFile() accessor and config.ValidateAgentsFile()
with security validation (path traversal, symlinks, extension check)
- Add --agents-file flag to bd init with config persistence
- Thread configured filename through init_agent.go
- Update setup/agents.go to use config.AgentsFile()
- Update doctor checks to search configured filename
- Update onboard messaging to reference configured filename
- Add DefaultAgentsFile constant for consistent fallback
The filename is persisted to .beads/config.yaml under agents.file
and read by all subsystems via config.AgentsFile().
Fixes#2737
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>