# Programowanie od specyfikacji

EN: **Spec-driven development with coding agents** · id `specdriven` · aliases: spec-driven development, SDD, specification-first development, rozwój sterowany specyfikacją

Path: [AI Atlas](https://aiatlasgraph.com/llms.txt) › [Aplikacje LLM i agenci](https://aiatlasgraph.com/t/applications.md) › [Agenci kodujący](https://aiatlasgraph.com/t/aicoding.md) › Programowanie od specyfikacji

## Description

- PL: Najpierw powstaje ustrukturyzowana specyfikacja, często także plan techniczny i lista zadań; materiały te kierują pracą agenta i mogą pozostać punktem odniesienia dla dalszych zmian.
- EN: A structured specification is created first, often together with a technical plan and task list; these artifacts guide the agent and may remain a reference point for later changes.

## In one sentence

- PL: Zanim sztuczna inteligencja napisze kod, razem spisujecie, co dokładnie ma robić program, i dopiero według tego planu powstaje kod.
- EN: Before AI writes any code, you and it write down exactly what the program should do, and the code follows that plan.

## Problem it solves

- PL: Asystent pisze kod, który wygląda poprawnie, ale robi coś innego, niż chciałeś, bo prośba była zbyt ogólna.
- EN: An assistant writes code that looks right but does something other than you wanted, because the request was too vague.

## What it does

- PL: Jak budowa domu według projektu architekta: najpierw rysunki i kosztorys, które obie strony zatwierdzają, a dopiero potem murowanie.
- EN: Like building a house from an architect's drawings: first plans and estimates both sides approve, and only then the bricklaying.

## Everyday example

- PL: Zanim zespół doda logowanie do aplikacji, asystent spisuje wymagania i kroki, ludzie je poprawiają, a potem asystent wykonuje zadania jedno po drugim.
- EN: Before a team adds sign-in to an app, an assistant writes requirements and steps, people correct them, then the assistant completes the tasks one by one.

## This concerns you if you…

- PL: zlecasz asystentowi większe zmiany niż jedna poprawka
- PL: chcesz móc sprawdzić plan, zanim powstanie kod
- EN: give an assistant changes bigger than a single fix
- EN: want to review a plan before code is written

## Keywords

Spec Kit · Kiro · Tessl · requirements · acceptance criteria · task breakdown · plan mode · AGENTS.md

## How it works

- PL: Praca może przechodzić od specyfikacji wymagań przez plan techniczny i listę zadań do implementacji. Wyróżnia się podejścia spec-first, spec-anchored i spec-as-source, zależnie od tego, jak długo specyfikacja pozostaje wiążąca.
- EN: Work may proceed from a requirements specification through a technical plan and task list to implementation. Spec-first, spec-anchored, and spec-as-source approaches differ in how long the specification remains authoritative.

## Limits

- PL: Rozbudowane specyfikacje w markdownie bywają trudniejsze do przejrzenia niż sam kod i nie pasują do małych zmian. Agent i tak potrafi zignorować instrukcje; podejście przypomina wcześniejsze, nieudane próby generowania kodu z modeli.
- EN: Lengthy markdown specs can be harder to review than code and do not fit small changes. Agents may still ignore instructions; the approach echoes earlier failed attempts at generating code from models.

## Key terms

- PL: **specyfikacja**: Opis zachowania programu i kryteriów jego akceptacji.
- PL: **plan techniczny**: Wybrana architektura, technologie i ograniczenia realizacji.
- PL: **spec-as-source**: Ludzie edytują tylko specyfikację, a kod jest z niej generowany.
- EN: **specification**: A description of program behaviour and its acceptance criteria.
- EN: **technical plan**: Chosen architecture, technologies and implementation constraints.
- EN: **spec-as-source**: People edit only the spec; code is generated from it.

## Know first

- [Prompty i kontekst (Prompting and context engineering)](https://aiatlasgraph.com/t/prompting.md)
- [Role i tożsamość agentów (Agent roles and identity)](https://aiatlasgraph.com/t/agentroles.md)

## Related topics

Untyped, symmetric "see also" links.

- [Role i tożsamość agentów (Agent roles and identity)](https://aiatlasgraph.com/t/agentroles.md)

## Sources

- [Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl](<https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html>) `fowler-sdd-2025` · by Birgitta Böckeler (Thoughtworks), na martinfowler.com
- [Spec-driven development with AI: Get started with a new open source toolkit](<https://github.blog/ai-and-ml/generative-ai/spec-driven-development-with-ai-get-started-with-a-new-open-source-toolkit/>) `github-speckit-2025` · by Den Delimarsky (GitHub) · sponsored

---

AI Atlas revision 122 (2026-10-30) · HTML: https://aiatlasgraph.com/t/specdriven · index: https://aiatlasgraph.com/llms.txt · everything: https://aiatlasgraph.com/llms-full.txt · updated 2026-10-30