marketing-shibata50/claude-code-ultimate-guide

Florian BRUNIAUX c84c56bfbd docs: add AI Traceability & Attribution guide

Comprehensive documentation on AI code attribution and disclosure:

- New guide: guide/ai-traceability.md (~640 lines)
  - LLVM "Human-in-the-Loop" policy (Assisted-by trailer)
  - Ghostty mandatory disclosure pattern
  - Fedora contributor accountability framework
  - git-ai tool documentation
  - PromptPwnd security vulnerability
  - Four-level disclosure spectrum
  - Implementation guides (solo, team, enterprise)

- Templates: examples/config/
  - CONTRIBUTING-ai-disclosure.md
  - PULL_REQUEST_TEMPLATE-ai.md

- Cross-references added to:
  - ultimate-guide.md (after Co-Authored-By section)
  - learning-with-ai.md (after Vibe Coding Trap)
  - security-hardening.md (See Also)
  - guide/README.md (table of contents)

- reference.yaml: 14 new entries for AI traceability topics

Source: Vibe coding needs git blame (Piotr Migdał, Jan 2026)
+ Perplexity research on LLVM, Ghostty, Fedora policies

Co-Authored-By: Claude <noreply@anthropic.com>

2026-01-24 20:11:53 +01:00

1.9 KiB

Raw Blame History

AI Assistance Disclosure (CONTRIBUTING.md Template)

Copy this section into your project's CONTRIBUTING.md

AI Assistance Disclosure

If you use any AI tools to help with your contribution, please disclose this in your pull request description.

What to Disclose

AI Usage	Example Disclosure
AI-generated code	"This PR was written primarily by Claude Code"
AI-assisted research	"I consulted ChatGPT to understand the codebase"
AI-suggested approach	"Copilot suggested the algorithm structure"
AI-drafted docs	"Documentation was drafted with Claude assistance"

What Doesn't Need Disclosure

Trivial autocomplete (single keywords, short phrases)
IDE syntax helpers (formatting, auto-imports)
Grammar/spell checking
Code formatting tools (prettier, black)

Why We Ask

AI-generated code often requires more careful review:

May use patterns unfamiliar to the codebase
Could introduce subtle bugs humans wouldn't make
Might miss project-specific conventions
Sometimes "looks right" but has logical issues

Disclosure helps maintainers:

Allocate review time appropriately
Know where to look more carefully
Provide better feedback on AI usage

This is a courtesy to reviewers, not a judgment on AI use.

Suggested Disclosure Format

In your PR description:

## AI Assistance

This PR was developed with assistance from [Tool Name].
Specifically:
- [What AI helped with]
- [What you did manually]

All code has been reviewed and understood by the author.

Attribution

Based on policies from:

For more context, see AI Traceability Guide.

1.9 KiB Raw Blame History