ciunkos.com/Glossary

Coding with agents

Comprehension debt

The growing gap between how much code a system has and how much of it anyone on the team actually understands, a typical cost of fast AI-written code.

Addy Osmani defines it as “the growing gap between how much code exists in your system and how much of it any human being genuinely understands”. Code that nobody wrote by hand and nobody read closely can work fine, until it has to be changed, debugged at night or explained to an auditor. Then the team pays: slow fixes, fear of touching modules and a growing bus factor problem.

It differs from technical debt: the code can be clean and still not understood. Vibe coding produces it fastest; agentic engineering keeps it in check with specs, reviewed plans, architecture notes and asking the agent to explain changes, not only to make them.

Sources

Share: LinkedIn · X ·

Related terms

  • Technical debt: Shortcuts in code and design that speed up delivery now and make every later change slower until they are paid back.
  • Vibe coding: Building by prompting and accepting the result without reading the code closely.
  • Bus factor: How many people would have to disappear before a project stalls. A bus factor of one means one person holds the keys.
  • Agentic engineering: Professional software work in which coding agents write most of the code while engineers own the specs, the checks, the review and the result.
  • Parallel agents (git worktrees): Running several coding agents at the same time on one repository, each in its own git worktree and branch, so their edits do not collide.

Linked from

← All terms

Free tools

Business idea validatorTen rubrics, a fixed-rule verdict and three cheap experiments. Free.Software cost estimatorYour project among 125 real products, with honest ranges.Engagement configuratorPick the work and its size, see hours, price and start date.SPF, DKIM and DMARC checkerGrade any domain’s email DNS, with records to paste.BIMI checkerRecord, DMARC, SVG Tiny PS logo and VMC or CMC, with an inbox preview.App store readiness checkWhat your web app lacks for the stores, TWA or Capacitor, files to copy.Build or buy calculatorSaaS against your own app over 1, 3 or 5 years, with the payback month.Runbook generatorA RUNBOOK.md for a system only you know, in two minutes, in your browser.SLA calculatorMonthly fee, response times, a downtime budget and contract clauses.Local model or API?Does the model fit your hardware, how fast, what it costs against an API.OpenAPI to MCP toolsPaste an OpenAPI spec, get narrow MCP tools and a server skeleton.KSeF invoice validatorCheck an FA(3) invoice against the official schema in your browser.Quoting time calculatorHours spent turning inquiries into quotes, and when an agent pays off.Multi-tenant SaaS calculatorWhich multi-tenant model, the work per release and the weeks to get there.Quote DeskDrop a customer inquiry, get lines matched to your price list. Free.AI Visibility DeskDoes Claude recommend your brand? Weekly runs of your buyers’ questions, free.List DeskClean an email list in your browser: dead domains, disposable, typos, duplicates.Eval DeskTest cases for your AI prompt, run after every change: what regressed, what got fixed.Dashboard DeskA growth dashboard created in your PostHog, plus what your tracking is missing.Signature DeskOne email signature template for the whole team, as HTML for Gmail, Outlook and Apple Mail.Phishing email checkerForward a suspicious email or upload the .eml file; three AI models and technical checks give a verdict.Email TestSend one email, check one-click unsubscribe, SPF, DKIM, DMARC and spam signals.Vitals DeskA daily lab check of your pages on a throttled phone: LCP, CLS and TBT, and an email when a page gets slower. Free.Legacy rewrite estimateLines of code to function points, hours and cost, with and without agents.

Want the fun version? The Corporate-speak Translator has a Polish dictionary of office phrases and what they really mean. Corporate-speak dictionary (Polish) →

Need this built, fixed or reviewed?

I build and rescue products with AI coding agents under rules: AI features in production, honest estimates, email that gets delivered.

Przemysław Zalewski

How I work

Przemysław Zalewski · 15+ years shipping software

“a true bias for action” client CTO, public LinkedIn recommendation

My pledge

All principles, the AI policy and working hours →

Pricing · Security · Privacy and analytics opt-out · Trust center