Andrez Segovia

Understanding Spec-Driven-DevelopmentNote

There are three SDD implementations:

  1. Spec-first: A well thought-out spec is written first, and then used in the AI-assisted development workflow for the task at hand.
  2. Spec-anchored: The spec is kept event after the task is complete, to continue using it for evolution and maintenance of the respective feature.
  3. Spec-as-source: The spec is the main source file over time, and only the spec is edited by the human, the human never touches the code.

What is a spec? A spec is a structured, behavior-oriented artifact —or a set of related artifacts— written in natural language that expresses software functionality and serves as guidance to AI coding agents.

AI-Friendly Code DesignNote

Supervised software engineering agents are increasingly capable of identifying necessary updates and making larger changes to a codebase. At the same time, we’re seeing growing complacency with AI-generated code, and developers becoming reluctant to review large AI-made change sets. A common justification for this is that human-oriented code quality matters less since AI can handle future modifications; however, AI coding assistants also perform better with well-factored codebases, making AI-friendly code design crucial for maintainability.

Augmented Coding Patternswebsite

A collection of emerging patterns, anti-patterns and obstacles for effective AI-augmented software development.

A Project of One's OwnNote

“[..]. Working on a project of your own is as different from ordinary work as skating is from working. It’s more fun, but also much more productive.”

Skills WebsiteBookmark

A website to find a good amount of skills.