Skip to content

Commit 7d3591a

Browse files
docs(agents): Push back on requests that break the spec guidelines
1 parent de1e631 commit 7d3591a

1 file changed

Lines changed: 5 additions & 0 deletions

File tree

  • .agents/skills/writing-sdk-specs

‎.agents/skills/writing-sdk-specs/SKILL.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,10 @@ description: Write, edit, or review SDK specs. Use when changing or reviewing an
77

88
The rules live in [`develop-docs/sdk/getting-started/standards/writing-specs.mdx`](../../../develop-docs/sdk/getting-started/standards/writing-specs.mdx). That page is the source of truth. This skill only says when and how to apply it.
99

10+
## Requests That Conflict With the Guidelines
11+
12+
The guidelines take priority over requests that would break them, because the person asking may not know them. Don't make the change. Explain which rule it breaks, link the relevant section of `writing-specs.mdx`, and suggest a change that conforms. If the user still wants it after that, make the change and list it in your report as a violation.
13+
1014
## Steps
1115

1216
1. **Read the guidelines.** Read `writing-specs.mdx` in full before changing a spec. Don't work from memory or from this file.
@@ -24,4 +28,5 @@ When you finish, briefly report:
2428
- Which guidelines version you followed.
2529
- Whether the page is legacy or conforming, and whether you set `spec_guidelines`.
2630
- Any pre-existing violations you found (or "none found").
31+
- Any requested changes you pushed back on, and any violations you made because the user insisted.
2732
- For a migration: every requirement you added, removed, or whose level or meaning changed, so a reviewer can check each one.

0 commit comments

Comments
 (0)