Stop letting documentation rot
Five types of documentation, five different AI leverage stories. The question isn’t whether to involve AI in your docs; it’s where each type belongs and how much maintenance you can hand off.
The blog · since 2015
Essays, playbooks and field notes from our CTOs, architects and leads. Written for people shipping real product.
Five types of documentation, five different AI leverage stories. The question isn’t whether to involve AI in your docs; it’s where each type belongs and how much maintenance you can hand off.
The standard AI-assisted dev loop has created a new bottleneck: us. Peter Eysermans describes how deterministic orchestration via n8n, with GitHub as shared memory, gets the human off the loop without sacrificing quality.
When an AI agent gets a requirement wrong, the mistake lives in the test assertions, not the implementation. Domain knowledge catches it, not coding skill.
The processes that got you here will eventually constrain you. Like a lobster shedding its shell, scaling companies must periodically dismantle what worked intentionally, not in panic. Constraints aren’t a failure; they’re proof you’ve outgrown your current structure.
AI has removed the junior work that used to build software engineers. Seven other industries faced the same disruption and didn't agree on an answer.
"Vibe coding" has become shorthand for bad engineering to some people, but does the label hold up? This post unpacks how a playful term coined by Andrej Karpathy became a verdict, and why that's costing teams more than they realise.
LLMs generate code fast, but knowledge debt accumulates quickly. The fix is living documentation, and this post shows how to turn your LLM into the partner that maintains it automatically.
The fastest way to learn agentic development is to stop studying it: move in, extract repeatable patterns into skills, and reflect to compound.
Ever wanted to build your own Google Docs-style document service? This post introduces WOPI, the open protocol that lets web applications embed Office document editing directly in the browser, while keeping your app in control of storage and permissions.
A mobile app, past its usefulness, was days from being phased out. One email reversed the decision. No discussion. No input from engineering. This is what happens when decision-making drifts too far from the work.
In part three, we look at both sides of the AI contribution debate. A working patch, real demand, never submitted, rejected because AI was involved. But maintainers are unpaid volunteers, and AI halved the cost of contributing without touching the cost of review. Both sides have a point.
We smile at the 18th-century crowd for being swept up by a box with a man inside, yet today it's easy to hand ChatGPT a vague idea and treat the PRD it returns as gospel. Generative AI is genuinely powerful. We get the best from it when we bring both enthusiasm and a critical eye.
Developers don't skip standards because they're careless, they skip them because there are fifteen things to remember and the code was the hard part. The real question isn't which tasks your LLM handles well. It's what's still slipping through ungated.
The AI wave is here, and the industry is already splitting into two: those adapting fast and those falling behind. The gap is widening quickly.
The machines aren't replacing developers, they're promoting them. You're no longer just writing code; you're managing agents, reviewing output, and setting standards. Three Claudes walk into a codebase, and suddenly you're a manager.
Managing multiple Claude Code accounts across machines gets messy fast. Jean-Claude keeps the useful parts in sync, separates account-specific config, and makes switching between personal, team, and client setups far less painful.
AI & agentic tooling
We use AI and agentic workflows daily. From coding agents to AI strategy, we help teams adopt what actually works.
Read our AI insightsEngineering leadership
We <3 sharing content for CTOs, senior engineers and founders with real-world insights.
40+ expert authorsFor investors & VCs
Technical audits, codebase assessments, and risk analysis for portfolio managers making investment decisions.
Explore our investor contentOur staff engineers will get your software (back) on track and lead your engineering team. We prepare our exit from day one: our goal is to bring the software and the team to the right level for us to get out again.
Learn more about software engineeringOur CTOs in residence (or fractional CTOs) inject technical leadership into your team, ensuring the technical aspect of your business gets exactly the right attention.
Learn more about CTO as a serviceWe're the market leader for technical due diligence of SaaS companies in Belgium and The Netherlands, servicing clients all over the world. Investors appreciate our smooth process, sharp opinions and top-notch reports.
Learn more about auditingBehind-the-scenes support for your CTO or technical lead to enhance their skills, drive effective change, and grow their teams confidently.
Learn more about CTO coachingWe can help you find the best talent to join your team. Unlike other recruiters, we are CTOs and software engineers ourselves, and through getting our hands dirty, we know the skills required to make an impact.
Learn more about recruitingSometimes your struggles go beyond the technical. Do you need help evaluating the roadmap or sharpening the vision? What should you build in order to scale? Our product management experts know the way.
Learn more about product management