Skip to content

Conversation

dhofheinz
Copy link

Adds reference to the comprehensive agent development guide that codebuff init-agents creates.

Changes

  • Added 13-line callout after init-agents command explaining what gets created
  • Shows directory structure (.agents/README.md, examples, types, etc.)
  • Directs users to the 293-line comprehensive guide at .agents/README.md

Why

Users currently don't know that init-agents creates extensive documentation (1,493+ lines total across all files). This addition surfaces the comprehensive guide that already exists, improving discoverability without adding bloat to the main README.

The template README contains detailed documentation on agent structure, available tools, testing workflows, publishing process, best practices, and advanced patterns - but users had no way to know it existed from reading the main README.

Addresses common Windows-specific issues reported in CodebuffAI#294, CodebuffAI#274, CodebuffAI#299:
- Network/proxy configuration for version check failures
- Git Bash/WSL recommendations for git command compatibility
- Browser login workarounds for Git Bash users
- Clarification on "Update available: error" message

All solutions are configuration/workflow guidance with no code changes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant