helio.
  • About
  • POSTS
  • Português

Clean-Code


Featured Posts

Teaching the Agent How to Work: Claude Code, Skills, and Agentic Collaboration

Architecture defines where logic belongs. Skills define how change unfolds.

In the previous article, I argued that agent productivity is not primarily a tooling problem. It is an architectural one. If your repository is ambiguous, agents amplify ambiguity. If boundaries are … »
October 17, 2025
ai  claude-code  agentic-workflows  clean-code  hexagonal-architecture  developer-experience  workflow-engineering 

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.