helio.
  • About
  • POSTS

Software-Architecture


Featured Posts

When the Agent Asks Back: Interactive Planning and Specification Boundaries

Specification ambiguity is the last bottleneck. Interactive planning is how you fix it.

I asked the agent to add a new validation rule. The architecture was clean. The skill was loaded. The agent followed the protocol perfectly: domain first, tests second, adapters last. And it built the … »
October 30, 2025
ai  claude-code  agentic-workflows  planning  software-architecture  developer-experience 

It is time for Agent-Friendly Codebase

Stop rewriting prompts. Start fixing your repository.

An “agent-friendly codebase” is not a codebase where an AI can write code. That part is already easy. The uncomfortable bit is whether an AI agent can do the job you actually want done: … »
August 7, 2025
ai  software-architecture  refactoring  clean-code  hexagonal-architecture  testing  developer-experience 

     •  helio.