Skip to content

Document debugging, profiling, and local go-microvm workflow#108

Merged
JAORMX merged 1 commit intomainfrom
jaosorior/docs-debugging-profiling
Apr 7, 2026
Merged

Document debugging, profiling, and local go-microvm workflow#108
JAORMX merged 1 commit intomainfrom
jaosorior/docs-debugging-profiling

Conversation

@JAORMX
Copy link
Copy Markdown
Contributor

@JAORMX JAORMX commented Apr 7, 2026

Summary

  • Add Debugging & Profiling section to CLAUDE.md with --trace, --timings, BBOX_TRACE, BBOX_KEEP_VM_DATA usage
  • Document local go-microvm development workflow (replace directive, force rebuild, fetch-runtime gotcha)
  • Add internal/infra/tracing/ to the infrastructure layer listing

These were all discovered during the startup performance investigation and are essential for future debugging sessions.

🤖 Generated with Claude Code

Add Debugging & Profiling section to CLAUDE.md covering:
- --trace and --timings flags for startup profiling
- BBOX_KEEP_VM_DATA=1 to preserve VM data dir for debugging
- OTel trace span hierarchy overview
- Local go-microvm development workflow with replace directive
- fetch-runtime gotcha when go-microvm tags lack release assets

Also add internal/infra/tracing/ to the infrastructure layer listing.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@JAORMX JAORMX merged commit d52e807 into main Apr 7, 2026
8 checks passed
@JAORMX JAORMX deleted the jaosorior/docs-debugging-profiling branch April 7, 2026 07:37
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