Workflow on Osmar Petry

ADR — Architecture Decision Records

Wed, 15 Jan 2025 00:00:00 +0000

ADRs (Architecture Decision Records) are essential documents in software engineering that capture important architectural choices and the context behind them. In an Obsidian vault, ADRs integrate naturally into project documentation.

Why use ADRs?

In long-running projects — such as framework migrations or service changes in Go or Java — decisions change constantly. Without recording why a tool was chosen over another, the team (or even yourself) may forget the reasoning months later, losing the context that justified the choice.

Agile Software Development

Wed, 15 Jan 2025 00:00:00 +0000

Agile is a set of values and principles for software development that emphasizes flexibility, collaboration, and iterative delivery. Rather than following a rigid plan, Agile teams adapt to changing requirements and deliver working software frequently.

What is Agile?

Agile is not a single methodology but rather a philosophy that encompasses various frameworks and practices. The core idea is to break down large projects into smaller, manageable pieces that can be delivered incrementally.

Shape Up: Stop Running in Circles and Ship Work that Matters

Wed, 15 Jan 2025 00:00:00 +0000

Summary

In December 2020 I read several books and papers: The Mythical Man-Month, Design by Contract, Programming with Abstract Data Types, Shape Up, and Domain-Driven Design. Their ideas map directly to problems and solutions I encountered building apps in recent years. The largest recurring gap in real projects is the beginning—how we shape and refine the work—more than the middle or the end. Shape Up gives a concrete way to close that gap in modern teams.