Paweł Domański
30 lines
1.8 KiB
Markdown
30 lines
1.8 KiB
Markdown
---
|
|
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. 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).
|
|
|
|
## Sources
|
|
- [[summaries/building-personal-ai-assistant-sqlite-gtd]]
|
|
- [[summaries/obsidian-vault-as-knowledge-graph]]
|
|
|