{"slug": "follow-existing-patterns-is-not-enough-context-for-an-ai-coding-agent", "title": "Follow Existing Patterns” Is Not Enough Context for an AI Coding Agent", "summary": "A developer argues that AI coding agents fail when given vague instructions like 'follow existing patterns' because they lack the implicit organizational knowledge that human engineers bring. The developer asserts that teams must digitize tribal knowledge into explicit documentation to guide AI agents effectively, turning quality standards into actionable context.", "body_md": "Many engineering teams give AI coding agents instructions that sound perfectly clear:\n\nFollow existing patterns.\n\nDo not introduce new abstractions.\n\nUse the established architecture.\n\nFollow project standards.\n\nA human developer can usually interpret those instructions because the words are only part of the communication. The developer also brings professional experience, familiarity with the codebase, conversations with teammates, code-review feedback, and an understanding of how the organization makes engineering decisions.\n\nThe human fills in the missing context.\n\nAn AI coding agent does not necessarily make the same expansion. It may recognize the existing pattern in one layer while overlooking another place where the same principle should apply. It may reproduce the visible structure of a nearby implementation without understanding why that structure exists.\n\nThis does not mean general engineering principles are useless. It means they are incomplete when they stand alone.\n\nA useful instruction must route the agent toward authoritative context. It should identify which architecture guide, repository standard, testing guidance, data-access convention, security requirement, or implementation example the agent must review before beginning the task.\n\nThe goal is not to copy every rule into every prompt. That creates duplication, contradiction, and drift. The goal is to maintain canonical engineering documentation and explicitly direct agents toward the relevant sources.\n\nThis is also why some criticism of AI-generated software misses part of the problem.\n\nCritics are right to object to insecure code, fragile systems, unnecessary abstractions, inconsistent implementations, and applications that nobody can maintain. But many of those failures are not proof that AI has no useful role in engineering. They are signs that organizations are using agents without adapting how engineering knowledge is communicated.\n\nExperienced engineers often carry large amounts of organizational knowledge implicitly. They know which patterns are intentional, which compromises are temporary, which architectural boundaries matter, and which production lessons must never be forgotten.\n\nAI systems do not inherit that cultural understanding automatically.\n\nOrganizations have to digitize it.\n\nThat means turning tribal knowledge into explicit organizational intelligence that can guide both humans and AI systems. It means preserving not only what a codebase does, but why it works the way it does and which decisions should not be casually reversed.\n\nThe teams that do this well will not merely generate code faster. They will make the quality standards of experienced engineers available at the point where AI-assisted work actually occurs.\n\nI explore the complete argument in:\n\nOriginally published on [bdonaldharris.com](https://bdonaldharris.com/writing/the-myth-of-general-ai-instructions).", "url": "https://wpnews.pro/news/follow-existing-patterns-is-not-enough-context-for-an-ai-coding-agent", "canonical_source": "https://dev.to/bdonald/follow-existing-patterns-is-not-enough-context-for-an-ai-coding-agent-18kd", "published_at": "2026-07-28 22:33:35+00:00", "updated_at": "2026-07-28 23:32:03.913784+00:00", "lang": "en", "topics": ["artificial-intelligence", "developer-tools", "ai-agents"], "entities": ["bdonaldharris.com"], "alternates": {"html": "https://wpnews.pro/news/follow-existing-patterns-is-not-enough-context-for-an-ai-coding-agent", "markdown": "https://wpnews.pro/news/follow-existing-patterns-is-not-enough-context-for-an-ai-coding-agent.md", "text": "https://wpnews.pro/news/follow-existing-patterns-is-not-enough-context-for-an-ai-coding-agent.txt", "jsonld": "https://wpnews.pro/news/follow-existing-patterns-is-not-enough-context-for-an-ai-coding-agent.jsonld"}}