feat: add agent guidance and memory system for v0.6.0#13
Conversation
…elopment Why: Establish foundation for agent-assisted development with persistent context Approach: Adapted otlp-mcp's BOTS.md guidance to otel-cli's philosophy Learned: otel-cli's functional testing approach and self-contained design are key differentiators Next: Use GitHub issues to track ongoing work and maintain visibility Added: - BOTS.md with otel-cli-specific agent guidance - CLAUDE.md and GEMINI.md symlinks for model-specific access - Emphasis on functional testing over unit tests - Git-based memory system (vs jj in otlp-mcp) - GitHub issues integration for project tracking This marks v0.6.0, the beginning of the agent-assisted development era. Refs #12 🤖 Claude <claude@anthropic.com>
There was a problem hiding this comment.
Pull Request Overview
This PR introduces an agent-assisted development framework for otel-cli, marking the transition to v0.6.0. It establishes comprehensive guidance for LLM agents working with the codebase, adapted from otlp-mcp but tailored to otel-cli's philosophy of functional testing, self-contained design, and shell script integration.
Key Changes
- Added BOTS.md with detailed agent development protocols including git-based memory, testing philosophy, and project structure
- Created model-specific symlinks (CLAUDE.md, GEMINI.md) pointing to BOTS.md for easy agent access
- Updated CHANGELOG.md to document the v0.6.0 release and agent-assisted development milestone
Reviewed Changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| BOTS.md | Comprehensive agent guidance document covering project philosophy, testing practices, git workflows, and collaboration patterns |
| CLAUDE.md | Symlink to BOTS.md for Claude-specific access |
| GEMINI.md | Symlink to BOTS.md for Gemini-specific access |
| CHANGELOG.md | Version 0.6.0 release notes documenting the introduction of agent-assisted development |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| - Cobra for CLI framework | ||
| - gRPC and HTTP OTLP exporters | ||
| - **Version Control**: Git with GitHub integration | ||
| - **Current Version**: 0.5.0 (as of this writing) |
There was a problem hiding this comment.
The version is listed as 0.5.0, but the CHANGELOG.md shows this PR introduces v0.6.0. Update to '0.6.0' to reflect the new version being released.
| - **Current Version**: 0.5.0 (as of this writing) | |
| - **Current Version**: 0.6.0 (as of this writing) |
| @@ -1,3 +1,20 @@ | |||
| ## [0.6.0] - 2025-11-09 | |||
There was a problem hiding this comment.
The release date is set to '2025-11-09' (November 9), but your knowledge cutoff indicates it's currently November 2025. If this date hasn't occurred yet or is incorrect, please verify and update to the actual release date.
| ## [0.6.0] - 2025-11-09 | |
| ## [0.6.0] - UNRELEASED |
Why: Project maintains clean linear history via squash merges Approach: Added guidance to GitHub Integration and workflow sections Learned: Important to document that branch commits can be messy, squash on merge Next: Update PR description to reflect this addition 🤖 Claude <claude@anthropic.com>
🤖 Claude <claude@anthropic.com>
|
Updated BOTS.md to include squash commit guidance:
This aligns with the existing clean, linear history in the project. 🤖 Claude claude@anthropic.com |
Why: README needed clarity on fork status and agent-assisted development Approach: Cleaned up status section, added agent info to Contributing Learned: Keep focus on otel-cli as great CLI tool for OTEL signals Next: Push and update PR Changes: - Replaced rambling status with clear fork statement - Added 'Amy & the bots' as active maintainers - Documented agent-assisted development starting v0.6.0 - No MCP mention - otel-cli stays focused on CLI excellence - Improved Contributing section with agent and human guidance - Cleaned up contact information and links - Updated License section for clarity 🤖 Claude <claude@anthropic.com>
🤖 Claude <claude@anthropic.com>
|
Updated README.md to clarify project status and agent development: Changes:
The README now clearly communicates the project's direction while maintaining its existing style. 🤖 Claude claude@anthropic.com |
Why: Clarify copyright for fork continuation Approach: Extended Packet Host to include Equinix Metal, added 2025 copyright Learned: Apache 2.0 allows accumulation of copyright notices Next: Push final changes to PR Changes: - Extended 'Packet Host, Inc.' to 'Packet Host, Inc. / Equinix Metal' - Added 'Copyright 2025 A. Tobey' for fork continuation 🤖 Claude <claude@anthropic.com>
🤖 Claude <claude@anthropic.com>
|
Final update: LICENSE file
This properly attributes both the original work and the fork continuation. PR is now complete and ready for review/merge! ✅ 🤖 Claude claude@anthropic.com |
Summary
Brings in the agent guidance and memory system from otlp-mcp, adapted for otel-cli's philosophy and practices. This marks v0.6.0, the beginning of the agent-assisted development era.
Changes
Key Differences from otlp-mcp
main_test.goover unit testsTest Plan
Related
Closes #12
🤖 Generated with Claude Code
Co-Authored-By: Claude noreply@anthropic.com