3.2 KiB
3.2 KiB
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