Guidance for AI coding agents working in this repository. This is the tool-agnostic summary; CLAUDE.md holds the full detail and takes precedence where the two overlap.
GitHub's special .github repository for the @perishdev organization. It holds community health files and the org profile page. There is no application code, no build system, and no test suite — do not scaffold one.
- Blast radius. Community health files (
SECURITY.md,CODE_OF_CONDUCT.md,CONTRIBUTING.md,SUPPORT.md,GOVERNANCE.md, and the issue/PR/discussion templates) are inherited by every repo in the org that lacks its own copy. A change here silently changes the default everywhere. - Absolute links only in inherited files. Use
https://github.com/perishdev/...URLs, never relative paths — relative links break when GitHub renders the file in another repo's context. - Not inherited:
FUNDING.ymland.github/workflow-templates/affect only this repo.FUNDING.ymlhere is a commented reference template. - No default license is possible; the repo-level
LICENSEstands alone.
- Commits: Conventional Commits v1.0.0
- Branches: Conventional Branch —
feature/*,fix/*,docs/*, offmain. - PR titles: Conventional Pull Request format.
- Open PRs against
main.
Read CLAUDE.md for the full layout and rationale. When editing an inherited file, consider every downstream repo, not just this one.