# Sources

Central bibliography for `clean-code-guard`. Other reference files use source
names instead of inline URLs so rule guidance stays readable.

## Contents

- Classic clean code and design references
- LLM code-generation research and field reports
- Metrics and verification references

## Classic Clean Code And Design

- **Clean Code sample chapters**: https://ptgmedia.pearsoncmg.com/images/9780132350884/samplepages/9780132350884.pdf
- **Command Query Separation, Fowler**: https://martinfowler.com/bliki/CommandQuerySeparation.html
- **Refactoring, Fowler**: https://martinfowler.com/books/refactoring.html
- **YAGNI, Fowler**: https://martinfowler.com/bliki/Yagni.html
- **DRY, The Pragmatic Programmer excerpt**: https://media.pragprog.com/titles/tpp20/dry.pdf
- **The Wrong Abstraction, Sandi Metz**: https://sandimetz.com/blog/2016/1/20/the-wrong-abstraction
- **SOLID principles, Uncle Bob archive**: http://butunclebob.com/ArticleS.UncleBob.PrinciplesOfOod
- **SRP, Uncle Bob**: https://blog.cleancoder.com/uncle-bob/2014/05/08/SingleReponsibilityPrinciple.html
- **OCP, Uncle Bob**: https://blog.cleancoder.com/uncle-bob/2014/05/12/TheOpenClosedPrinciple.html
- **LSP, Liskov/Wing paper mirror**: https://www.labri.fr/perso/clement/enseignements/ao/LSP.pdf
- **DIP, Object Mentor archive**: https://web.archive.org/web/20150924054349/http://www.objectmentor.com/resources/articles/Principles_and_Patterns.pdf

## LLM Code-Generation Research And Field Reports

- **GitClear AI code quality 2025**: https://www.gitclear.com/ai_assistant_code_quality_2025_research
- **Package Hallucinations, Spracklen et al., USENIX Security 2025**: https://www.usenix.org/system/files/conference/usenixsecurity25/sec25cycle1-prepub-742-spracklen.pdf
- **AI-Generated Code Considered Harmful**: https://arxiv.org/abs/2409.19182
- **A Deep Dive Into LLM Code Generation Mistakes**: https://arxiv.org/abs/2411.01414
- **Patterns for Reducing Friction in AI-Assisted Development, Fowler**: https://martinfowler.com/articles/reduce-friction-ai/
- **Claude Code issue 6984, mock data generation bias**: https://github.com/anthropics/claude-code/issues/6984
- **Karpathy on exception suppression**: https://x.com/karpathy/status/1976077806443569355
- **Code Needs Comments**: https://arxiv.org/html/2402.13013v1
- **Evaluating the Code Quality of AI-Assisted Code Generation Tools (Copilot, CodeWhisperer, ChatGPT)**: https://arxiv.org/abs/2304.10778
- **On Mitigating Code LLM Hallucinations with API Documentation**: https://arxiv.org/abs/2407.09726
- **LLM Hallucinations in Practical Code Generation (taxonomy)**: https://arxiv.org/abs/2409.20550
- **When Names Disappear: Revealing What LLMs Actually Understand About Code**: https://arxiv.org/abs/2510.03178
- **Neural Variable Name Repair**: https://arxiv.org/abs/2512.01141
- **Vibe Coding in Practice**: https://arxiv.org/abs/2512.11922

## Metrics And Verification

- **McCabe NIST 235r**: https://www.mccabe.com/pdf/mccabe-nist235r.pdf
- **Cognitive Complexity, SonarSource**: https://www.sonarsource.com/docs/CognitiveComplexity.pdf
- **ReSharper cyclomatic complexity threshold guidance**: https://github.com/JetBrains/resharper-cyclomatic-complexity/blob/master/docs/ThresholdGuidance.md