Paweł Domański
1.8 KiB
title, type, tags, created, updated, sources, confidence
| title | type | tags | created | updated | sources | confidence | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Agent Contracts (Kontrakty Agentów) | concept |
|
2026-06-09 | 2026-06-09 |
|
high |
Agent Contracts (Kontrakty Agentów)
Definition
Wzdrzec architektoniczny polegający na umieszczeniu w katalogu głównym projektu specjalnego pliku (np. CLAUDE.md lub AGENTS.md), który definiuje nienaruszalne reguły gry, konwencje kodowania, strukturę bazy wiedzy oraz ograniczenia behawioralne dla agentów AI działających w tym środowisku.
How It Works
Sesje z terminalowymi agentami AI (np. entities/claude-code) są bezstanowe. Każda nowa sesja zaczyna się od zera. Umieszczenie kontraktu w pliku o stałej lokalizacji sprawia, że agent odczytuje go automatycznie przy uruchomieniu i odzyskuje pełny kontekst operacyjny. Kontrakt zazwyczaj zawiera:
- Strukturę katalogów: Co znajduje się w poszczególnych folderach.
- Konwencje techniczne: Standardy linkowania (np. Knowledge BaseLinks), formatowanie YAML, styl nazewnictwa.
- Instrukcje bezpieczeństwa (Negative Instructions): Czego agentowi bezwzględnie nie wolno robić (np. modyfikować folderu z szablonami, usuwać plików bez potwierdzenia).
- Aktywny kontekst: Nad czym aktualnie pracuje użytkownik i co powinno być priorytetem bieżącej sesji.
Why It Matters
Kontrakt agenta przekształca generyczny model językowy w zdyscypliniowanego programistę lub zarządcę bazy wiedzy. Zapewnia powtarzalność operacji i drastycznie minimalizuje tarcie konfiguracyjne (brak konieczności każdorazowego instruowania agenta w oknie czatu).