Skip to content

docs(agents): file issues for out-of-scope findings; never fake capability coverage#1478

Merged
xuyushun441-sys merged 1 commit into
mainfrom
docs/agents-file-issues
Jun 1, 2026
Merged

docs(agents): file issues for out-of-scope findings; never fake capability coverage#1478
xuyushun441-sys merged 1 commit into
mainfrom
docs/agents-file-issues

Conversation

@xuyushun441-sys
Copy link
Copy Markdown
Contributor

Adds Prime Directive #10 to AGENTS.md:

File issues for out-of-scope findings — don't silently expand scope or leave them buried. When you hit a bug/gap/unenforced capability unrelated to the task (or too large to fix in scope), open a GitHub issue and link it from your PR. Corollary: never advertise or demo a capability the runtime doesn't actually deliver (declared ≠ enforced).

Motivated by this session's finding that the spec declares 9 validation-rule types but the write-path validator enforces only 3 — now tracked in #1475 (plus #1476 map basemap, #1477 exotic-chart plugin) instead of being faked in the showcase.

🤖 Generated with Claude Code

…ility coverage

Add Prime Directive #10: when you encounter a bug/gap/unenforced capability
that's unrelated to the task or too large to fix in scope, open a GitHub issue
and link it — don't silently expand scope or leave it buried. Corollary: never
advertise or demo a capability the runtime doesn't deliver (declared ≠
enforced). Cites the validation-rule enforcement gap (#1475) as the example.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Building Building Preview, Comment Jun 1, 2026 2:38pm

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/xs labels Jun 1, 2026
@xuyushun441-sys xuyushun441-sys merged commit 35ac16e into main Jun 1, 2026
10 of 11 checks passed
@xuyushun441-sys xuyushun441-sys deleted the docs/agents-file-issues branch June 1, 2026 14:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/xs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants