mirror of
https://github.com/cozystack/cozystack.git
synced 2026-11-05 03:27:07 +09:00
Aleksei Sviridkin
c87cccae99
## What this PR does Two independent cleanups in agent-facing documentation: 1. **Refocus `docs/agents/contributing.md` on project-side conventions.** The file previously mixed project rules (commit format, PR structure) with personal workflow preferences (e.g. "do not commit automatically, show the diff first", subjective guidance on how to evaluate AI-bot review comments). Personal preferences belong in individual contributors' own agent config (`~/CLAUDE.md` or equivalent), not in a shared project doc that every agent reads. This PR keeps only the project-side artifacts: what a commit/PR must look like when it reaches the repository. 2. **Adopt Conventional Commits.** Recent commit history mixes `[component]` prefix and `type(scope):` styles. This PR picks Conventional Commits and aligns all agent-facing docs and the PR template on it, so contributors and bots get one consistent answer. Also documents the `Assisted-By:` trailer convention for AI-authored commits. Changes: - `.github/PULL_REQUEST_TEMPLATE.md`: update guidance and release-note example - `docs/agents/contributing.md`: drop personal workflow guidance, link to the PR template instead of duplicating it, switch examples to Conventional Commits, document `Assisted-By:` trailer - `docs/agents/overview.md`, `AGENTS.md`, `.gemini/styleguide.md`: update commit format references ### Release note ```release-note docs: adopt Conventional Commits (`type(scope): description`) for commit and PR titles ``` <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Documentation** * Switched contribution & PR guidance to Conventional Commits (`type(scope): description`) and added explicit allowed types, scope examples, and breaking-change notation (`!` or `BREAKING CHANGE:`). * Updated PR template, release-note expectations, validation messaging, and contributor checklist to match the new convention. * Added AI Agent Attribution trailers for assisted commits and streamlined branch/PR workflow guidance (rebase/cleanup and PR creation examples). <!-- end of auto-generated comment: release notes by coderabbit.ai -->