---
title: "Agent Contracts (Kontrakty Agentów)"
type: "concept"
tags: [agent-orchestration, system-design, prompt-engineering]
created: 2026-06-09
updated: 2026-06-09
sources: ["[[summaries/building-personal-ai-assistant-sqlite-gtd]]", "[[summaries/obsidian-vault-as-knowledge-graph]]"]
confidence: 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. WikiLinks), 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).

## Sources
- [[summaries/building-personal-ai-assistant-sqlite-gtd]]
- [[summaries/obsidian-vault-as-knowledge-graph]]