Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Planowanie

contract-first

/contract-first

Zamienia prośbę o funkcję, zmianę zachowania lub usunięcie w uzgodniony kontrakt zachowania, zanim ktokolwiek napisze kod.

Licencja
MIT
Ostatnia zmiana repozytorium
06.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 06.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zamienia prośbę o funkcję, zmianę zachowania lub usunięcie w uzgodniony kontrakt zachowania, zanim ktokolwiek napisze kod.

Wyzwalacze z opisu

I wantletcan we make itchange how X worksremove Y
Oryginalny opis (EN)

Turn a feature request, behaviour change, or removal into an agreed behaviour contract before any code is written. Use whenever the user says "I want", "let's add", "can we make it", "change how X works", or "remove Y", and whenever requirements are loose, even if they do not ask for a spec or design.

Jak działa

  1. Process
  2. Changing an existing contract
  3. Common mistakes
Sekcje z nagłówków SKILL.md, w oryginale · 62 linii, 415 słów
Podgląd SKILL.md
---
name: contract-first
description: Turn a feature request, behaviour change, or removal into an agreed behaviour contract before any code is written. Use whenever the user says "I want", "let's add", "can we make it", "change how X works", or "remove Y", and whenever requirements are loose, even if they do not ask for a spec or design.
---

# Contract First

Agree on **observable behaviour** before touching code. The contract is the shared definition of
"done". Everything later (tests, implementation, review) is measured against it.

The contract describes what a consumer of the system can observe. It never describes how the code works inside.

## Process

### 1. Orient (read before asking)
Read the relevant code, existing contracts in `contracts/`, tests, and recent commits. Do not ask the
user things the repository already answers.

### 2. Clarify (one question at a time)
Ask only what you cannot discover. Prefer multiple-choice questions. Stop when you can state the
behaviour in your own words: who consumes it, what they do, what they observe.

### 3. Name the seam
Decide where the behaviour is observed: an HTTP endpoint, a CLI command, a screen, a public function,
an emitted event. The outermost seam that exists in the project is the right one. State it explicitly.

### 4. Draft the contract tree
One clause per line, nested by cause. Use only these openers:

```
when <trigger arrives>
  while <standing condition holds>
    if <branching condition>
      then <observable outcome>
      and <further observable outcome>
```

Rules for every line:
- It is observable from outside the seam.
- It names no function, class, table, or library.
- A test could pass or fail on it. If you cannot imagine the test, rewrite the line.
- Failure paths get lines too: invalid input, missing permission, dependency down.

See `references/example.md` for a complete example.

### 5. Present in digestible chunks
Show the tree in pieces short enough to read (one `when` block at a time). After each, ask whether it
matches intent. Record non-goals explicitly so scope does not creep.

### 6. Record and hand off
- **Non-trivial change:** save to `contracts/<subject>.contract.md` with the header
  `Contract: <subject> (seam: <where observed>)`.
- **Small change (a few clauses):** agree in chat; no file.

Then continue with `outside-in-tdd`. Do not start implementing until the user has approved.

## Changing an existing contract
Edit the existing file rather than adding a parallel one. Show the diff of clauses (added, removed,
changed) and get approval before code changes. A contract changes only when the user's intent changes.

## Common mistakes
- Writing implementation steps ("add a column", "call the service") instead of outcomes.
- Skipping failure paths because the happy path feels like the whole feature.
- Asking five questions at once. Ask one.
- Treating approval of a vague summary as approval of behaviour. Approve the clauses.
Pliki w paczce (2)
  • SKILL.md 3 KB
  • references/example.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · Mosin112/engineering-harness100MIT
affaan-m/ECC100MIT
SHRIJANAGAIN/Nemo-Cli100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 044727fa49a5 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 86plan-feature
    Planuje nową funkcję Roastpilot najpierw jako specyfikację, zanim napisze się kod zmieniający zachowanie.
  • 90brainstorming
    Zamienia niejasną prośbę w uzgodniony projekt, wymagając zgody na rozwiązanie przed jakąkolwiek implementacją.
  • 85spec
    Zamienia luźny pomysł, prośbę o funkcję lub opis problemu w uporządkowaną specyfikację gotową do wdrożenia.
  • 90dev10x:spec-update
    Prowadzi zmianę zachowania przez aktualizację specyfikacji przed kodem, a dopiero potem regeneruje implementację.
  • 90intent-contract
    Zamienia niejasne zlecenie w pisemny kontrakt z kryteriami zakończenia i decyduje, czy działać, czy zapytać.
  • 90to-spec
    Zamienia uzgodniony plan w specyfikację inżynierską z ponumerowanymi historyjkami, akceptacją i dowodem dla każdej, punktami testowymi i źródłami.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.