May 26, 2026
Agentic development wasn't working for my large codebase. Then I implemented anchor tags
Agentic development works great until your codebase gets big.
As the repo grows, the AI starts missing context. greps gets unreliable. Planning looks detailed but quietly skips important files. Validation becomes harder. And after enough agentic coding, you end up with random orphaned code scattered throughout the codebase.
I spent months trying to solve this problem, and the thing that finally made a major difference was adding anchor tags throughout my codebase.
In this video, I walk through what anchor tags are, why they help, and how I use them to make large-scale agentic development more reliable.
The basic idea: anchor tags are metadata inside the codebase that give AI a deterministic, queryable system for understanding where things live, how features connect, and what needs to be included during planning and validation.
Instead of asking AI to “go research the codebase,” we can point it toward a manifest, have it query relevant anchor surfaces, and then use normal grep/search on top of a much better starting point.
This has helped me:
- Improve planning accuracy in large codebases
- Reduce orphaned and leftover legacy code
- Validate refactors with more confidence
- Link related code across services
- Connect test coverage back to product surfaces
- Give AI a better map of the repo without pretending it understands everything
I also talk through how we pair anchor tags with policy-as-code rules, why the tag system needs to stay boring, and why this only works if the metadata is enforced consistently.
This is not a perfect system, and I’m not claiming anchor tags magically solve agentic development. But for large codebases, they’ve been one of the most useful changes I’ve made.
If you’re using AI coding agents on a large repo and running into context, planning, or validation issues, this is worth trying.
Topics covered:
- Why agentic development breaks down in large codebases
- What anchor tags are
- How anchor tags create deterministic codebase context
- Why AI misses things even with large context windows
- Using manifests and custom queries for planning
- Validating deprecated features and refactors
- Reducing orphan code
- Pairing anchor tags with policy-as-code
- Mapping tests to code surfaces
- Practical rules for keeping anchor tags useful
If you want the presentation or have questions about implementing this in your own codebase, drop a comment or reach out.
Like and subscribe if you want more videos on agentic development, AI coding workflows, QA, automation, and building software with large language models.
Watch on YouTube →