docs(attribution): automate Claude Code attribution in commands and workflows

[alirezarezvani]

Summary

Implement automatic Claude Code attribution in all user-facing automated operations (commands, workflows, agents) while removing manual attribution from Claude's development activities.

Problem

Currently, Claude Code attribution appears inconsistently:

• ❌ Added manually by Claude in every commit/PR during development
• ❌ Not present in automated command/workflow operations
• ❌ No clear guidelines on where it should/shouldn't appear

This creates:

• Noise in development commits
• Inconsistent user experience
• Missing attribution in actual automated features

Solution

Phase 1: Foundation ✅ (This PR)

1. Commit Template (.github/commit-template.txt)

• Added attribution footer to template
• All commits using template automatically include attribution

2. Comprehensive Documentation (docs/ATTRIBUTION.md, 283 lines)

• Clear guidelines on where attribution MUST appear
• Clear guidelines on where attribution should NOT appear
• Implementation checklist (15 items)
• Code examples for all scenarios
• Customization instructions

Phase 2: Implementation (Remaining Work)

Commands (6 files in .claude/commands/github/):

• /commit-smart - Add attribution to commit instructions
• /create-pr - Add attribution to PR body instructions
• /release - Add attribution to release PR/notes
• /kill-switch - Add attribution to emergency commits
• /review-pr - Add attribution to review comments
• /sync-status - Add attribution to status comments

Agents (3 files in .claude/agents/):

• plan-converter.md - Add attribution to issue creation
• workflow-manager.md - Add attribution to comments
• blueprint-setup.md - Add attribution to setup commits

Workflows (6 files in .github/workflows/):

• claude-plan-to-issues.yml - Add attribution to issues
• pr-into-dev.yml - Add attribution to validation comments
• dev-to-main.yml - Add attribution to gate comments
• create-branch-on-issue.yml - Add attribution to branch comments
• pr-status-sync.yml - Add attribution to status updates
• release-status-sync.yml - Add attribution to release comments

Key Principle

Attribution is for USER-FACING AUTOMATED OPERATIONS only:

✅ Include attribution:

• Commits created by /commit-smart command
• PRs created by /create-pr command
• Issues created by claude-plan-to-issues workflow
• Comments posted by automation workflows
• Releases created by /release command

❌ Do NOT include attribution:

• Claude's manual commits during development
• Claude's exploratory PRs during debugging
• Validation error messages
• System warnings

Changes in This PR

• docs/ATTRIBUTION.md - New comprehensive guidelines (283 lines)
• .github/commit-template.txt - Added attribution footer (8 lines)

Total: +291 insertions

Testing

• Commit template includes attribution correctly
• Documentation covers all scenarios
• Implementation checklist is complete
• Commands updated (Phase 2)
• Agents updated (Phase 2)
• Workflows updated (Phase 2)

Next Steps

1. Review and approve this foundation PR
2. Implement Phase 2 - Update 15 files (commands/agents/workflows)
3. Test end-to-end - Verify attribution appears correctly
4. Deploy - Merge to main

Benefits

• Consistency: Attribution appears uniformly in all automated operations
• Transparency: Users know which operations are AI-assisted
• Cleaner Development: No attribution noise in Claude's dev commits
• Discoverability: Links to Claude Code for others to learn
• Professionalism: Clear separation of automated vs manual operations

---

This PR establishes the foundation. Phase 2 will update all commands/agents/workflows to follow these guidelines.