Jedna linia w AGENTS.md sprawiła, że Claude Code i Codex podążali za kodem, a nie za przestarzałą dokumentacją
Jedna linia w AGENTS.md sprawiła, że Claude Code i Codex podążali za kodem, a nie za przestarzałą dokumentacją
Badacze wykazali, że agenci kodujący często podążają za przestarzałą dokumentacją, nawet gdy widzą sprzeczności z rzeczywistym kodem. Jedna instrukcja w AGENTS.md zwiększyła podążanie za istniejącym kodem z 4% do 91%.
Jeśli Twój AGENTS.md stał się przestarzały, Claude Code może zauważyć, że dokumentacja nie odpowiada już rzeczywistemu kodowi, i mimo to nadal podążać za starymi instrukcjami.
Badacze celowo stworzyli taką sytuację i przeprowadzili 80 uruchomień. W 79 przypadkach Claude Code rozpoznał sprzeczność, ale i tak wpadł w tę pułapkę.
W przypadku Codex sytuacja była jeszcze gorsza: mniej więcej w jednym na cztery przypadki zaczął przepisywać już działający kod tylko po to, aby dostosować go do przestarzałej dokumentacji.
Poprawka okazała się zaskakująco prosta. Wystarczy dodać do AGENTS.md jedną linię. Po tym obaj agenci zaczęli podążać za istniejącym kodem w 91% przypadków zamiast wcześniejszych 4%:
„Jeśli dokumentacja repozytorium jest sprzeczna z istniejącym kodem, postępuj zgodnie z konwencjami przyjętymi w samym kodzie, a w końcowej odpowiedzi wskaż każdą znalezioną rozbieżność między dokumentacją a kodem”.
Dlaczego to ważne
AnalizaPrzestarzałe instrukcje mogą po cichu obniżać jakość kodowania z udziałem agentów. Nadanie priorytetu kodowi nad dokumentacją pomaga agentom rzadziej łamać działające zachowania i dokładniej raportować niespójności.
Dyskutuj w społeczności
Dziel się swoimi pytaniami i spostrzeżeniami z programistami
Powiązane w ekosystemie
Praktyczne poradniki, kluczowa terminologia i skille agentów
Claude Code Projects: jak jeden AI koordynuje zespół autonomicznych agentów
Głęboka analiza Claude Code Projects: architektura Coordinator i Threads, równoległe gałęzie, wspólna pamięć MEMORY.md oraz zarządzanie agentami w chmurze.
Codex jako asystent wewnątrz Claude Code: Delegowanie rutynowych zadań przez Claudex
Prawdziwą ograniczeniem w pracy z Claude nie jest to, jak dobrze model rozumuje, ale ile zadań mieści się w oknie kontekstowym, zanim zostanie ono wypełnione.
Claude Code
Oficjalny terminalowy agent deweloperski od Anthropic, działający bezpośrednio w linii komend za pośrednictwem modelu Claude 3.7 Sonnet z natywną obsługą Bash, Git, systemu plików oraz protokołu MCP.
Claude domyślnie będzie używać Auto Mode do zarządzania uprawnieniami w planach Pro, Max i Team
Anthropic poinformował, że od przyszłego tygodnia Claude będzie domyślnie korzystać z Auto Mode do zarządzania uprawnieniami w planach Pro, Max i Team.
improve-codebase-architecture
Refactor messy codebases into clean, modular, and maintainable layered architectures.
code-review
Official code review capability by @mattpocock. Streamlines autonomous ai-agents tasks and workflows.