Skip to content

docs: Merge AI instruction files AGENTS.md CLAUDE.md copilot-instructions.md, symlink, fixes #7632 [skip ci]#7644

Merged
rfay merged 6 commits into
ddev:mainfrom
rfay:20250920_rfay_move_to_AGENTS.md
Sep 22, 2025
Merged

docs: Merge AI instruction files AGENTS.md CLAUDE.md copilot-instructions.md, symlink, fixes #7632 [skip ci]#7644
rfay merged 6 commits into
ddev:mainfrom
rfay:20250920_rfay_move_to_AGENTS.md

Conversation

@rfay
Copy link
Copy Markdown
Member

@rfay rfay commented Sep 20, 2025

The Issue

How This PR Solves The Issue

  • Merge the contents of the 3 files
  • Use one AGENTS.md
  • Symlink the other "needed" items to AGENTS.md

Manual Testing Instructions

Take a look

rfay and others added 4 commits September 20, 2025 07:12
- Add enhanced project structure descriptions with directory purposes
- Include additional build commands (make clean, build output paths)
- Add testing commands (make quickstart-test) and environment variables
- Include coding style & naming conventions section
- Add commit message format with Conventional Commits examples
- Include security & configuration tips from AGENTS.md
- Maintain existing Claude Code-specific guidance structure

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add AI language guidelines to avoid AI-revealing words
- Include development environment setup (temp dirs, command wrapping)
- Add Claude Code configuration patterns with file exclusions
- Include common DDEV command allowlist for permissions
- Add GitHub MCP server setup instructions for automation
- Add markdown formatting fixes for proper linting

Consolidates useful patterns from personal Claude configuration
to benefit all DDEV contributors using Claude Code.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Consolidate development guidance from .github/copilot-instructions.md:

- Add enhanced testing strategy with timing information (5-30s for packages, 30-120s for subsets)
- Include detailed 4-step validation workflow for post-change verification
- Add troubleshooting section with prerequisites and common CI/environment issues
- Include PATH management guidance for testing built binaries
- Add environment notes about network timeouts and container limitations

This creates a unified AI-vendor-agnostic development guide that combines
the best practices from Claude Code, GitHub Copilot, and AGENTS.md sources.

Source: .github/copilot-instructions.md

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@rfay rfay requested a review from a team as a code owner September 20, 2025 13:36
@rfay rfay requested a review from stasadev September 20, 2025 20:51
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 with a little nitpick.

Comment thread AGENTS.md Outdated
Co-authored-by: Stanislav Zhuk <stasadev@gmail.com>
Comment thread AGENTS.md Outdated
@rfay rfay merged commit b4f6aa1 into ddev:main Sep 22, 2025
4 checks passed
@rfay rfay deleted the 20250920_rfay_move_to_AGENTS.md branch September 22, 2025 13:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants