AI-Human Attribution Tracking Skill

Ethical AI collaboration attribution tracking system for software projects

📦 What's Inside

This skill provides a complete framework for tracking contributions between human developers and AI assistants (like Claude Code, ChatGPT, Copilot, etc.).

Files

ai-human-attribution-skill/
├── README.md                        # This file
├── SKILL.md                         # Skill overview for Claude Code
├── TEMPLATE_USER_GUIDE.md           # Comprehensive user guide
├── TEMPLATE_API_REFERENCE.md        # Technical specification
└── templates/
    └── ATTRIBUTION.md.template      # Attribution file template

🚀 Quick Start

1. Install the Skill

Option A: Claude Code CLI

# Copy skill folder to Claude Code skills directory
cp -r ai-human-attribution-skill ~/.claude/skills/

Option B: Manual Import
- Open Claude Code
- Settings → Skills → Import Skill
- Select SKILL.md from this folder

2. Initialize Attribution in Your Project

# Copy the template
cp ai-human-attribution-skill/templates/ATTRIBUTION.md.template your-project/AI-HUMAN-ATTRIBUTION.md

# Edit the header section with your project details
nano your-project/AI-HUMAN-ATTRIBUTION.md

3. Add to Your README

## Attribution

This project uses AI-assisted development with ethical attribution tracking.
See [AI-HUMAN-ATTRIBUTION.md](./AI-HUMAN-ATTRIBUTION.md) for details.

4. Start Tracking

When working with Claude Code, the skill will:
- Ask about attribution before starting work
- Document contributions as you go
- Update your attribution file automatically

📚 Documentation

For Users

• SKILL.md - Start here! Overview of the skill and how it works
• TEMPLATE_USER_GUIDE.md - Detailed guide with examples, scenarios, and FAQs

For Developers

• TEMPLATE_API_REFERENCE.md - Technical specification, data structures, algorithms

Templates

• templates/ATTRIBUTION.md.template - Copy this to start tracking in a new project

🎯 Key Features

✅ What It Tracks

• Who did what across 4 development phases
• Conceptualization (ideas)
• Analysis (architecture)
• Implementation (coding)

• Validation (testing)

• Contribution levels

• Principal (led the work)
• Support (assisted)
• Equal (collaborated)

• None (didn't participate)

• Metrics

• Overall project percentages
• Time estimates (human vs. AI)
• Phase-by-phase breakdown
• Deliverable tracking

🎨 The Framework

Based on a proven system used in real projects:

┌─────────────────────────────────────────────────────────────┐
│                  CONTRIBUTION BREAKDOWN                     │
├─────────────────────────────────────────────────────────────┤
│  Human: ██████████████████████████████░░░░░░░░░░░░░░ 65%    │
│  AI:    ░░░░░░░░░░░░░░░░░░░░░░░░░░████████████████░░ 35%    │
└─────────────────────────────────────────────────────────────┘

🌟 Why Use This?

For Solo Developers

• Build an honest portfolio
• Track your AI learning journey
• Understand AI's impact on your productivity

For Teams

• Transparent AI usage
• Fair credit distribution
• Onboarding documentation

For Agencies/Freelancers

• Client transparency
• Justify billing (human vs. AI time)
• Build trust through honesty

For Open Source

• Normalize ethical AI usage
• Share realistic AI workflows
• Contribute to AI literacy

📖 Example Entry

### 2025-01-15: User Authentication

**Phase**: Implementation + Validation

| Role | Human | AI |
|------|-------|-----|
| Conceptualization  | Principal - JWT vision | Support |
| Analysis           | Equal | Equal |
| Implementation     | Support | Principal - Auth0 code |
| Validation         | Principal - Testing | Support |

**Deliverables**:
- ✅ Login/signup forms
- ✅ JWT token management

**Tools Used**: Claude Code (Sonnet 4.5)
**Human Time**: ~2 hours (design, testing)
**AI Time**: ~45 minutes (implementation)
**Commit**: `abc1234`

**Notes**:
- Human designed auth flow
- AI implemented Auth0 SDK
- Human found and fixed token refresh bug

🔧 How It Works

1. Start a Task

You: "Build a user auth system"

Claude: "📊 Before I start, let's track attribution..."

2. Collaborate

Claude: "I'll implement Auth0 integration [AI: Principal]"
You: "I'll test the token refresh [Human: Principal]"

3. Document

Claude: Updates AI-HUMAN-ATTRIBUTION.md with:
- Contribution matrix
- Time estimates
- Deliverables
- Commit hash
- Context notes

4. Aggregate

Overall: Human 60%, AI 40%
Phase breakdowns updated

🤝 Contributing

This skill is open for improvement:

1. Fork the repository
2. Make your improvements
3. Submit a pull request

Areas for contribution:
- Additional export formats (JSON, CSV)
- Web UI for visual editing
- CI/CD integrations
- Team support (>1 human)
- Localization

📄 License

MIT License - Feel free to adapt and share

🙏 Credits

Created by: Based on the attribution system from @loscolmebrothers/home

Inspired by: The growing need for ethical AI attribution in software development

Version: 1.0.0
Last Updated: 2025-01-15

🔗 Resources

• Claude Code Documentation
• AI-Human Attribution Discussion
• Example Projects

Ready to track your AI collaborations ethically?

Start with SKILL.md 🚀