Skip to content

docs: codify agent quality guidelines#142

Merged
leehack merged 3 commits into
mainfrom
docs/agent-quality-guidelines
May 13, 2026
Merged

docs: codify agent quality guidelines#142
leehack merged 3 commits into
mainfrom
docs/agent-quality-guidelines

Conversation

@leehack

@leehack leehack commented May 13, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add AGENTS.md guidance for capability probes vs structural backend assumptions
  • Document Web/WebGPU bridge runtime expectations, WASMFS durability caveats, and actionable unsupported errors
  • Call out negative/version-skew regression coverage and docs/changelog alignment for public capability changes

Test Plan

  • git diff --check HEAD~1..HEAD
  • Markdown sanity check: no tabs/trailing whitespace

Notes

  • Documentation-only agent guidance update; no runtime code changes.

Copilot AI review requested due to automatic review settings May 13, 2026 12:29

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.

Pull request overview

This PR updates the repository’s agent guidance to better document how to reason about runtime capabilities (especially for web/WebGPU) and how to validate capability-dependent behavior.

Changes:

  • Adds new guidance on preferring capability probes over structural/interface assumptions, and on failing unsupported paths with actionable diagnostics.
  • Documents expectations for Web/WebGPU bridge versioning, durability caveats, and regression coverage (happy + negative/version-skew paths).
  • Extends testing standards to explicitly require coverage for unsupported/version-skew capability paths and user-guiding error messages.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread AGENTS.md Outdated
@codecov-commenter

codecov-commenter commented May 13, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.23%. Comparing base (c2c0adc) to head (0843024).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #142   +/-   ##
=======================================
  Coverage   78.23%   78.23%           
=======================================
  Files          75       75           
  Lines        9696     9696           
=======================================
  Hits         7586     7586           
  Misses       2110     2110           
Flag Coverage Δ
unittests 78.23% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@leehack leehack requested a review from Copilot May 13, 2026 12:43

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.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated

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.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

@leehack leehack merged commit 2f4189f into main May 13, 2026
10 checks passed
@leehack leehack deleted the docs/agent-quality-guidelines branch May 13, 2026 13:17
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.

3 participants