diff --git a/README.md b/README.md index 9322a42..db8c51e 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,11 @@ npx skills@latest add mattpocock/skills I built these skills as a way to fix common failure modes I see with Claude Code, Codex, and other coding agents. -### #1: The Agent Didn't Do What I Wanted +### #1: The Agent Didn't Do What I Want + +> "No-one knows exactly what they want" +> +> David Thomas & Andrew Hunt, [The Pragmatic Programmer](https://www.amazon.co.uk/Pragmatic-Programmer-Anniversary-Journey-Mastery/dp/B0833F1T3V) **The Problem**. The most common failure mode in software development is misalignment. You think the dev knows what you want. Then you see what they've built - and you realize it didn't understand you at all. @@ -41,6 +45,10 @@ These are my most popular skills. They help you align with the agent before you ### #2: The Agent Is Way Too Verbose +> With a ubiquitous language, conversations among developers and expressions of the code are all derived from the same domain model. +> +> Eric Evans, [Domain-Driven-Design](https://www.amazon.co.uk/Domain-Driven-Design-Tackling-Complexity-Software/dp/0321125215) + **The Problem**: At the start of a project, devs and the people they're building the software for (the domain experts) are usually speaking different languages. The domain experts are speaking their language, and the devs are trying to translate it into code. They're often talking past each other.