Skip to content

docs: update org-wide AI agent instructions#2

Merged
rfay merged 1 commit intomainfrom
20260430_minor_ai_updates
Apr 30, 2026
Merged

docs: update org-wide AI agent instructions#2
rfay merged 1 commit intomainfrom
20260430_minor_ai_updates

Conversation

@rfay
Copy link
Copy Markdown
Member

@rfay rfay commented Apr 30, 2026

The Issue

Org-wide CLAUDE.md/AGENTS.md/.github/copilot-instructions.md had several issues (all three are symlinks to AGENTS.md).

How This PR Solves The Issue

  • Remove "comprehensive" and "seamless" from text (the file itself bans these as AI writing tells)
  • Add git push prohibition: never push without explicit user confirmation
  • Add IDE diagnostics note: trust make/build tools over stale LSP diagnostics
  • Add Co-Authored-By template and git commit -F - pattern for markdown commit messages
  • Add preference for require over assert in tests
  • Remove Task Master AI section (references .taskmaster/CLAUDE.md which doesn't exist in most repos)

Manual Testing Instructions

  • Read the updated AGENTS.md and verify instructions are clear and consistent
  • Confirm CLAUDE.md and .github/copilot-instructions.md reflect the same content (they are symlinks)

Automated Testing Overview

No automated tests applicable for documentation changes.

Release/Deployment Notes

These instructions are automatically loaded by Claude Code for all repos in the ddev org. No action required in individual repos.

Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com

- Remove "comprehensive" and "seamless" from language
- Add git push prohibition
- Add IDE diagnostics note (trust make over LSP)
- Add Co-Authored-By template and git commit -F - pattern
- Prefer require over assert in tests
- Remove Task Master AI section (not relevant to most repos)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@rfay rfay requested a review from stasadev April 30, 2026 15:02
Copy link
Copy Markdown
Member

@stasadev stasadev left a comment

Choose a reason for hiding this comment

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

Looks good to me.

@rfay rfay merged commit da737ce into main Apr 30, 2026
@rfay rfay deleted the 20260430_minor_ai_updates branch April 30, 2026 18:39
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