Skip to content

[codex] Document resource budget diagnostics#504

Open
zergzorg wants to merge 1 commit into
robinebers:mainfrom
zergzorg:codex/resource-budget-docs
Open

[codex] Document resource budget diagnostics#504
zergzorg wants to merge 1 commit into
robinebers:mainfrom
zergzorg:codex/resource-budget-docs

Conversation

@zergzorg
Copy link
Copy Markdown
Contributor

@zergzorg zergzorg commented May 24, 2026

Summary

Part of #487.

This PR adds a resource-budget diagnostics guide for maintainers and contributors. It is intentionally docs-only so it does not interfere with the open code PRs in the #487 stack.

Changes:

  • add docs/resource-budget.md with repeatable commands for idle CPU/memory/thread baselines, long idle watch, child process watch, local HTTP API stress, and provider probe timing;
  • document expected healthy signals without treating any single CPU/RAM number as a hard limit;
  • add a PR review checklist for future background refresh/helper-command changes;
  • link the guide from the README.

This covers the #487 acceptance item for docs/maintainer notes describing expected idle behavior and measurement steps. It is independent from #498/#499/#500/#501/#502/#503 and can merge anytime.

Verification

  • git diff --check

Docs-only change; no runtime code or generated assets changed.


Summary by cubic

Adds a resource-budget diagnostics guide with repeatable commands for checking idle CPU, memory, threads, child processes, local HTTP API stress, and provider timing. Links it from the README and adds a PR review checklist; meets #487’s docs acceptance item.

Written for commit f7d61ce. Summary will update on new commits. Review in cubic

Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 2 files

Re-trigger cubic

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant