48 lines
3.2 KiB
Markdown
48 lines
3.2 KiB
Markdown
# 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
|