Jun 9, 2026, 4:07 PM

brain/knowledge/concepts/agent-contracts.md

@@ -0,0 +1,28 @@
+---
+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]]