Skip to content

docs(agents): add Engineering standard section to AGENTS.md#15

Merged
awdr74100 merged 1 commit into
mainfrom
docs/agents-engineering-standard
Jun 27, 2026
Merged

docs(agents): add Engineering standard section to AGENTS.md#15
awdr74100 merged 1 commit into
mainfrom
docs/agents-engineering-standard

Conversation

@awdr74100

Copy link
Copy Markdown
Owner

Adds an Engineering standard section to AGENTS.md so the quality bar is a default expectation for any agent/contributor working in this repo — not something that has to be requested per task.

It encodes, as operational guidance:

  • Equal-or-better, never a regression — adversarially stress-test your own change against diverse real designs before claiming it's good; verify, then assert.
  • Fix root causes — hunt the systemic miss-class (the recurring one: a multi-dimensional Figma property collapsed to one field or dropped), not the symptom; don't infer from the screenshot.
  • Don't gold-plate — effort goes where it moves fidelity/generality; smallest faithful fix wins.
  • Prove it on real designs — unit tests + a live round-trip (plugin connected), especially for read-path/serializer changes.

Docs-only; format:check and lint pass.

…use depth, no gold-plating

Make the quality bar a default contributor expectation rather than something
requested per-task: fidelity/generality is the moat, every change to existing
behaviour must be equal-or-better (adversarially stress-tested on real designs),
fix the systemic miss-class not the symptom, don't gold-plate, prove it live.
@awdr74100 awdr74100 merged commit f7da0bc into main Jun 27, 2026
2 checks passed
@awdr74100 awdr74100 deleted the docs/agents-engineering-standard branch June 27, 2026 18:35
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.

1 participant