{"id":20329386,"url":"https://github.com/ddev/.github","last_synced_at":"2026-03-19T15:18:02.889Z","repository":{"id":167017458,"uuid":"628341269","full_name":"ddev/.github","owner":"ddev","description":"Community Health templates for all of ddev","archived":false,"fork":false,"pushed_at":"2025-09-25T17:24:25.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-03-09T12:33:30.145Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ddev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":"FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":["ddev"],"custom":["https://www.paypal.com/donate/?hosted_button_id=MCNCSZHC7LHSQ","https://ddev.com/support-ddev/"]}},"created_at":"2023-04-15T16:38:52.000Z","updated_at":"2025-09-25T17:24:28.000Z","dependencies_parsed_at":"2026-03-09T10:02:03.510Z","dependency_job_id":null,"html_url":"https://github.com/ddev/.github","commit_stats":null,"previous_names":["ddev/.github"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ddev/.github","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2F.github","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2F.github/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2F.github/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2F.github/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ddev","download_url":"https://codeload.github.com/ddev/.github/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2F.github/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30710767,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-19T05:29:31.190Z","status":"ssl_error","status_checked_at":"2026-03-19T05:28:25.821Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-14T20:10:36.640Z","updated_at":"2026-03-19T15:18:02.872Z","avatar_url":"https://github.com/ddev.png","language":null,"funding_links":["https://github.com/sponsors/ddev","https://www.paypal.com/donate/?hosted_button_id=MCNCSZHC7LHSQ","https://ddev.com/support-ddev/"],"categories":[],"sub_categories":[],"readme":"# .github\n\nCommunity Health templates and AI agent instructions for all DDEV repositories.\n\n## Community Health Files\n\nGitHub automatically uses these files as defaults for any DDEV repository that doesn't have its own version:\n\n- `CONTRIBUTING.md` - Contribution guidelines\n- `CODE_OF_CONDUCT.md` - Code of conduct\n- `ISSUE_TEMPLATE/` - Issue templates\n- `PULL_REQUEST_TEMPLATE.md` - PR template\n- `SUPPORT.md` - Support information\n- `SECURITY.md` - Security policy\n\nFor more information, see [GitHub's community health documentation](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file).\n\n## AI Agent Instructions\n\nThis repository also provides organization-wide AI agent instructions through the **manual reference pattern**.\n\n### Files\n\n- **`AGENTS.md`** - Base AI agent instructions for all DDEV repositories\n- **`CLAUDE.md`** → `AGENTS.md` (symlink for Claude Code compatibility)\n- **`.github/copilot-instructions.md`** → `../AGENTS.md` (symlink for GitHub Copilot compatibility)\n\n### Strategy: Manual Reference Pattern\n\nSince AI agent instruction files (`AGENTS.md`, `CLAUDE.md`, `copilot-instructions.md`) are not GitHub community health files, they don't have automatic fallback behavior. Instead, we use a **manual reference pattern** where individual repositories explicitly reference the organization-wide instructions.\n\n**Why this approach:**\n- ✅ Works with any Git clone (no broken symlinks between repos)\n- ✅ Explicit and discoverable\n- ✅ Allows project-specific customization\n- ✅ Single source of truth for shared patterns\n- ✅ Compatible with all AI tools\n\n### Using in Your DDEV Repository\n\n#### For New Repositories\n\n1. **Create project-specific AGENTS.md:**\n\n```markdown\n# AGENTS.md\n\nThis file provides guidance to AI agents when working with [PROJECT_NAME].\n\n## Project Overview\n\n[Brief description of your project]\n\n## Project-Specific Development\n\n[Add project-specific content like:]\n- Key commands and testing approaches\n- Architecture notes\n- Special configuration requirements\n- Development workflow specifics\n\n## General DDEV Development Patterns\n\nFor standard DDEV organization patterns including communication style, branch naming, PR creation, security practices, and common development workflows, see the [organization-wide AGENTS.md](https://github.com/ddev/.github/blob/main/AGENTS.md).\n\n## Important Instruction Reminders\n\nDo what has been asked; nothing more, nothing less.\nNEVER create files unless they're absolutely necessary for achieving your goal.\nALWAYS prefer editing an existing file to creating a new one.\nNEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.\n```\n\n2. **Create tool-specific symlinks:**\n\n```bash\n# For Claude Code compatibility\nln -s AGENTS.md CLAUDE.md\n\n# For GitHub Copilot compatibility\nmkdir -p .github\nln -s ../AGENTS.md .github/copilot-instructions.md\n```\n\n#### For Existing Repositories\n\n1. **Update existing AGENTS.md** to include reference to org-wide version\n2. **Remove duplicated content** that's now covered by the org-wide file\n3. **Keep project-specific content** (testing, architecture, special workflows)\n4. **Ensure tool symlinks exist** as shown above\n\n### Examples\n\n- **[ddev/ddev](https://github.com/ddev/ddev/blob/main/AGENTS.md)** - Core DDEV with Go development, Docker architecture\n- **[ddev/ddev-upsun](https://github.com/ddev/ddev-upsun/blob/main/AGENTS.md)** - Add-on with Bats testing, PHP actions, Upsun integration\n\n### Content Organization\n\n**Organization-wide AGENTS.md covers:**\n- Communication style and AI language guidelines\n- Branch naming conventions\n- Pull request creation workflows\n- Security and configuration practices\n- Common development environment setup\n- General troubleshooting patterns\n\n**Project-specific AGENTS.md should cover:**\n- Project architecture and key components\n- Specific testing strategies and commands\n- Build processes and validation workflows\n- Domain-specific development patterns\n- Integration with external services or platforms\n\n### Maintenance\n\n- **Update shared patterns** in this organization-wide AGENTS.md\n- **Individual repositories** automatically benefit through references\n- **Project-specific content** remains in individual repository files\n- **No complex automation** or synchronization required\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddev%2F.github","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fddev%2F.github","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddev%2F.github/lists"}