from the log
2/21/2026 · 8 min read
— Ali Buğatekin
Recently, while I was heavily using AI agents in my development processes, I noticed a recurring problem: tasks that required repetitive but detailed context-setting.
Every time I wanted to delegate one of these tasks, I would open a new conversation, provide lengthy context, and repeat the same explanations. While getting the work done took seconds, explaining it took minutes.
This bottleneck pushed me to build an agent skill architecture.
Agents don't know the project context by default. You need to tell them:
every single time.
Initially, I tried putting agent folders inside the project (.claude, .cursor, etc.). But this approach had three major problems:
This was not sustainable.
To solve this problem, I built a structure I called agent-skills-mcp.
The idea was this:
Make skills a service, not a file.
Instead of keeping skills in the agent's local folder, I started serving them as MCP tools. These tools are not functions that write code — they are functions that provide guidance.
As a result:
Code is now written according to company standards, not individual developer standards.
There was another thing agents couldn't access by their nature: other projects.
For example:
Since the agent couldn't see these, I had to explain them every time.
To solve this, I gathered all company projects under a single root folder and connected a filesystem MCP to the agents.
But the critical point is this:
The agent is shown not the entire file system, but only the permitted folders.
This way, the agent can:
In other words, the agent is no longer an entity that knows only one repo — it becomes an entity that knows the organization's code map.
In the next step, I wanted the system to not only write code but actually get work done. For this, I connected agents to these systems:
The workflow now operates as follows:
1Do task DEV-1234 in JiraThe agent:
Then I say:
1Commit, push, and deploy to the test environmentAfter deployment starts:
The entire process is completed without leaving the IDE.
With this architecture in place, the following happened:
As a result, the software development process went through the following evolution:
The biggest difference is not speed.
Standardization.
Code is now written:
And this ensures:
Even when developers change, the system behavior does not change.
Seeing agents only as code-writing tools means missing out on enormous potential. The real breakthrough happens when you turn them into organizational memory and process engines.
At the point I've reached today, I can clearly say:
A properly configured agent infrastructure can make a small team work like a large one.
And this is just the beginning.
share if you found this useful