Manifesto

Intentional engineering in a cycle where agents and developers collaborate on creation.

Dev orchestrate · Agents execute

Context

"Mastery in the process, agility in the result."

SDG is a guide founded on clarity. We believe that intentional communication produces more robust software than the simple automated generation of content without review.

The challenge of noise

Rapid AI adoption without a solid technical foundation can increase technical and cognitive debt. When common standards are not cultivated, automated actions tend to generate noise rather than lasting solutions.

The SDG proposal

We propose a spec-driven lifecycle, where each step is born from a clear agreement and shared patterns. This reduces uncertainty and cultivates predictability within the project.

Foundations

Good software is born from consistent habits applied with dedication.

The value of the word

Every choice, from comments to function names, communicates an intent. Conscious communication is what distinguishes a readable system from a pile of noise.

ClarityIntentionality

Healthy habits

Naming rigor and a defensive posture flourish through intentional practice. Technical consistency is a living habit, refined with every new development cycle.

ConsistencyLearning

Reflection before construction

The order of actions in development protects the system as it grows. A careful plan is an investment that avoids future rework.

Spec-drivenPlanning

Partnership

You lead the intent. Your agent handles the execution.

Developer (sets the direction)

You define what to build and why. Domain knowledge, priorities, and final judgment stay with you.

Agent (writes the code)

The agent proposes solutions, generates code, and applies your project's patterns. You review what it produces.

Engineering playbook

Principles that stay with you through every new project.

Security belongs to the foundation

Defensive protections and access control support the project from the first draft, integrating naturally into the system structure.

Code is a conversation with the team

We write for the people who will maintain the system in the future. Every decision is a message left for our future selves and our peers.

Resilience is born from intent

Reliable systems are designed to handle failures gracefully. When we anticipate the unexpected, the system surprises us less at critical moments.

AI amplifies your standards

Solid principles guide the agent toward predictable results. The clarity of context you provide is what allows the assistant to act with precision.

Excellence by default

Open Source · Free forever

Most codebases that aged well started with one decision: take the fundamentals seriously.