Skip to content

Simplify agent guidance while preserving SDK contracts - #194

Open
niemyjski wants to merge 1 commit into
mainfrom
docs/streamline-agent-guidance
Open

niemyjski wants to merge 1 commit into
mainfrom
docs/streamline-agent-guidance

Conversation

@niemyjski

@niemyjski niemyjski commented Sep 22, 2026

Copy link
Copy Markdown
Member

The repository's agent instructions repeated SDK rules and required fixed delegation, review loops, and confirmation prompts even for small tasks. This consolidates shared contracts in AGENTS.md, keeps each agent role focused, and makes verification proportional to the change. It also shortens the SDK skill's discovery text and refreshes the existing browser skill through its installer without adding skills.

Validation: local formatting, metadata, 24 links, and skill inventory checks passed. Hosted build, lint, and tests passed on Linux, macOS, and Windows; CodeQL and CLA checks passed.

Merge gate: required reviewer approval is still pending.

Verification and implementation details
  • SDK source, examples, package manifests, dependency lockfile, and CI configuration are unchanged from main.
  • All 14 SDK reference guides and the SDK skill's integration rules are preserved verbatim.
  • Public API compatibility, zero production dependencies in core, privacy, async handling, and external-action authorization remain explicit.
  • Agent roles retain their names and responsibilities; model pins and mandatory orchestration are removed. The code reviewer retains its read-only tool restrictions.
  • The browser skill and skills-lock.json were refreshed together through npx skills; its contents were not manually edited. The installed skill set remains unchanged.
  • Local validation covers instruction integrity, not measured agent behavior. The existing PR CI passed application build, lint, and tests on all three platforms.

Verified revision: 7c547c2357436b68c67e197dd81b74d77baf6841. PR build results and CodeQL results.

Copilot AI lite review requested due to automatic review settings September 22, 2026 02:51
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 22, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-22T02:53:49.846292Z 7c547c2 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot review overview

🔵 Needs a closer look

A documentation claim needs correction, and hosted CI remains pending.

Review effort: Lite
Findings: None

What changed in this PR

This pull request consolidates agent guidance, simplifies role workflows, and refreshes managed skill metadata while preserving SDK contracts.

Changes:

  • Centralized shared SDK contracts and proportional verification guidance.
  • Simplified agent instructions and workflows.
  • Shortened the SDK skill and refreshed browser skill metadata.
File Summary
skills-lock.json Updated browser skill provenance hash
AGENTS.md Centralized repository and SDK guidance
.claude/​agents/​triage.md Streamlined triage workflow
.claude/​agents/​reviewer.md Simplified review guidance
.claude/​agents/​pr-reviewer.md Simplified PR readiness guidance
.claude/​agents/​engineer.md Simplified engineering workflow
.agents/​skills/​exceptionless-javascript/​SKILL.md Condensed SDK skill guidance
.agents/​skills/​agent-browser/​SKILL.md Refreshed managed browser skill

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

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