AddyOsmani.com - The Intent Debt

kept by eddie jun 08

Intent debt—the missing externalized rationale for why a system is built—is the most expensive kind of debt because AI agents cannot generate it, and its cost compounds as teams rely on more agents.

On cognitive debt
Nate Meyvis argues that cognitive debt in AI-generated codebases is not inherently worse than in traditional codebases, and AI can help mitigate it.
also on Margaret-Anne Storey, #software-engineering, #ai, #developer-tools
AddyOsmani.com - Comprehension Debt — the hidden cost of AI generated code.
Excessive reliance on AI coding tools creates comprehension debt—a growing gap between code volume and human understanding—that erodes system knowledge and eventually must be paid with interest.
also on Margaret-Anne Storey, #software-engineering, #developer-tools
A Complete Guide To AGENTS.md
An AGENTS.md file configures AI coding agent behavior, and should be kept minimal using progressive disclosure—only essential instructions like project description and package manager belong at the root, with other rules delegated to separate files.
also on AGENTS.md, #software-engineering, #productivity, #developer-tools
Using skills to accelerate OSS maintenance
Using skills, AGENTS.md, and GitHub Actions, OpenAI accelerated OSS maintenance in their Agents SDK repos, merging 457 PRs in three months, up from 316.
also on AGENTS.md, #software-engineering, #productivity, #developer-tools
Software Factories, Light and Dark (via @addyosmani)
A software factory is a harnessed loop at scale that can be run with humans trading judgment for speed, or fully automated without them.
also on Addy Osmani, #software-engineering, #productivity, #developer-tools