From 4a1f018f7cb13344193095f05897dd02815d226c Mon Sep 17 00:00:00 2001 From: "Armen Zambrano G." <44410+armenzg@users.noreply.github.com> Date: Thu, 26 Feb 2026 08:14:47 -0500 Subject: [PATCH 1/2] docs: Make commit and PR attribution agent-agnostic Update AGENTS.md so AI agents are instructed to use whatever Co-Authored-By line their tool provides (e.g. Cursor, Claude Code) instead of mandating Claude attribution. This avoids incorrect attribution when using other AI coding assistants. Made-with: Cursor --- AGENTS.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 695f4aed964ff..8d62df4d330c5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,10 +4,7 @@ Use **yarn**: `yarn install`, `yarn dev`, `yarn build`, `yarn test` ## Commit Attribution -AI commits MUST include: -``` -Co-Authored-By: Claude -``` +AI commits MUST include a `Co-Authored-By` line when the AI coding tool provides one (e.g. Cursor, Claude Code, or other assistants). Use the attribution your tool supplies; do not hardcode a specific agent or email. ## Development - `yarn dev` - Start dev server with Sentry sidecar @@ -69,6 +66,6 @@ When writing requirements in `develop-docs/`: - Make the plan extremely concise. Sacrifice grammar for the sake of concision. - At the end of each plan, give me a list of unresolved questions to answer, if any. -## Pull Request generation +## Pull Request generation -Use .github/PULL_REQUEST_TEMPLATE.md and add Co-Authored-By: Claude +Use .github/PULL_REQUEST_TEMPLATE.md and, if your AI tool provides a Co-Authored-By line, add it to the PR description. From fea86f177dd0ff6fb9439678bb6b5e77d9ebf4fa Mon Sep 17 00:00:00 2001 From: "Armen Zambrano G." <44410+armenzg@users.noreply.github.com> Date: Thu, 26 Feb 2026 10:44:44 -0500 Subject: [PATCH 2/2] docs: Integrate Co-Author requirement into git workflow Replace declarative rule with procedural workflow that includes Co-Authored-By as mandatory step 3. This addresses issue where agents may execute git procedures without checking workspace rules. Co-Authored-By: Cursor AI Made-with: Cursor --- AGENTS.md | 28 ++++++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 8d62df4d330c5..8e77c38669f5a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,8 +3,32 @@ ## Package Manager Use **yarn**: `yarn install`, `yarn dev`, `yarn build`, `yarn test` -## Commit Attribution -AI commits MUST include a `Co-Authored-By` line when the AI coding tool provides one (e.g. Cursor, Claude Code, or other assistants). Use the attribution your tool supplies; do not hardcode a specific agent or email. +## Git Commits + +When creating commits, follow this exact workflow: + +1. **Check status**: Run `git status` and `git diff` to see changes +2. **Draft message**: Write commit message following conventional commits format +3. **⚠️ ADD CO-AUTHOR**: Append to commit body: + ``` + Co-Authored-By: Cursor AI + ``` +4. **Stage files**: `git add` relevant files +5. **Commit**: Run the commit command with message that includes Co-Authored-By + +**Example commit command:** +```bash +git commit -m "$(cat <<'EOF' +feat: Add new feature + +Description of changes. + +Co-Authored-By: Cursor AI +EOF +)" +``` + +**IMPORTANT**: The Co-Authored-By line is REQUIRED in every AI-assisted commit. Do NOT skip step 3. ## Development - `yarn dev` - Start dev server with Sentry sidecar