Skip to content

docs: add context budget guidance#190

Open
caioribeiroclw-pixel wants to merge 1 commit into
agentsmd:mainfrom
caioribeiroclw-pixel:context-budget-guidance
Open

docs: add context budget guidance#190
caioribeiroclw-pixel wants to merge 1 commit into
agentsmd:mainfrom
caioribeiroclw-pixel:context-budget-guidance

Conversation

@caioribeiroclw-pixel
Copy link
Copy Markdown

Adds a small note that AGENTS.md is part of the agent context budget, so the default guidance should stay focused and link out to deeper docs when details are task-specific.

Why:

  • Recent discussion around AGENTS.md effectiveness is making context cost more visible.
  • The current page says "anything you'd tell a new teammate belongs here too", which is useful but can nudge people toward long up-front overviews.
  • This keeps the format simple while encouraging durable, task-relevant instructions.

Checks:

  • corepack pnpm exec tsc --noEmit
  • corepack pnpm run build
  • git diff --check

@vercel
Copy link
Copy Markdown

vercel Bot commented May 20, 2026

@caioribeiroclw-pixel is attempting to deploy a commit to the openai Team on Vercel.

A member of the Team first needs to authorize it.

Copy link
Copy Markdown

@Pjrich1313 Pjrich1313 left a comment

Choose a reason for hiding this comment

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

Jump and run diff merge into wave for audit

@caioribeiroclw-pixel
Copy link
Copy Markdown
Author

Thanks for taking a look. I re-ran the PR locally after the review note:\n\n- git diff --check origin/main...HEAD clean\n- corepack pnpm exec tsc --noEmit passed\n- corepack pnpm run build passed\n\nThe current Vercel failures look like deployment authorization for the upstream team, not a patch failure. The diff is intentionally copy-only and small: one focused context-budget step + one FAQ entry.\n\nIf you meant a specific audit/merge target by "diff merge into wave", point me at it and I can adjust the PR.

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.

2 participants