# Mapa dokumentów dla agenta

EN: **Repository map for agents** · id `harnessdocs` · aliases: AGENTS.md, docs as system of record, mapa repozytorium

Path: [AI Atlas](https://aiatlasgraph.com/llms.txt) › [Aplikacje LLM i agenci](https://aiatlasgraph.com/t/applications.md) › [Agenci i orkiestracja](https://aiatlasgraph.com/t/agentsnode.md) › [Uprząż agenta](https://aiatlasgraph.com/t/agentharness.md) › Mapa dokumentów dla agenta

## Description

- PL: Wejście agenta to krótka mapa do wersjonowanych dokumentów, a nie pełna instrukcja w jednym pliku.
- EN: The agent's entry point is a short map to versioned documents, not a full manual in one file.

## In one sentence

- PL: Krótka mapa na wejściu i reszta zasad w plikach, po które asystent sięga w razie potrzeby.
- EN: A short map at the start and the rest of the rules in files the assistant opens when needed.

## Problem it solves

- PL: Jedna wielka instrukcja szybko się starzeje, nie mieści w rozmowie i nie da się sprawdzić, czy jest aktualna.
- EN: One giant instruction soon goes stale, does not fit in the conversation and cannot be checked for freshness.

## What it does

- PL: Jak spis w szufladzie: krótka kartka mówi, gdzie leży regulamin, a sam regulamin zostaje w teczkach.
- EN: Like an index in a drawer: a short card says where the rules live, and the rules stay in the folders.

## Everyday example

- PL: Asystent zaczyna od krótkiej mapy projektu, a zasady nazewnictwa czyta dopiero wtedy, gdy ma zmienić pliki w danym miejscu.
- EN: The assistant starts from a short project map and reads the naming rules only when it is about to change files in that area.

## This concerns you if you…

- PL: zasady pracy nie mieszczą się w jednej wiadomości startowej
- PL: chcesz, by asystent czytał aktualne dokumenty, a nie starą ściągę
- EN: work rules do not fit in one starting message
- EN: want the assistant to read current documents, not an old cheat sheet

## Keywords

AGENTS.md · progressive disclosure · docs as system of record · repository legibility · doc gardening · architecture docs

## How it works

- PL: Krótki plik wejściowy, rzędu stu linii, wskazuje dokumenty z planem, architekturą i zasadami jakości. Agent czyta głębiej tylko przy zadaniu, które tego wymaga. Świeżość i linki da się wymuszać sprawdzianami w repozytorium, a osobny przebieg może zgłaszać nieaktualne dokumenty.
- EN: A short entry file, on the order of a hundred lines, points to documents for the plan, architecture and quality rules. The agent reads deeper only when the task needs it. Freshness and links can be enforced by repository checks, and a separate pass can flag stale documents.

## Limits

- PL: Mapa bez aktualnych dokumentów odsyła w pustkę. Wiedza spoza repozytorium, na przykład z czatu zespołu, pozostaje niewidoczna. Zbyt agresywne skracanie mapy usuwa wskazówkę, której agent potrzebuje na starcie.
- EN: A map without current documents points nowhere. Knowledge outside the repository, such as team chat, stays invisible. Cutting the map too aggressively removes a hint the agent needs at the start.

## Key terms

- PL: **plik mapy**: Krótki spis, który wskazuje, gdzie szukać reszty zasad.
- PL: **dokument źródłowy**: Wersjonowany plik z planem albo regułą, a nie ściąga w czacie.
- PL: **świeżość dokumentów**: Sprawdzenie, czy opis nadal pasuje do obecnego stanu pracy.
- EN: **map file**: A short index that says where the rest of the rules live.
- EN: **source document**: A versioned file with a plan or rule, not a note in chat.
- EN: **document freshness**: A check that the description still matches the current work.

## Know first

- [Zarządzanie oknem kontekstu (Context window management: placement, compaction and context rot)](https://aiatlasgraph.com/t/contextmanagement.md)
- [Budowa polecenia: instrukcje, rola i znaczniki (Prompt structure: instructions, roles and delimiters)](https://aiatlasgraph.com/t/promptstructure.md)

## Related topics

Untyped, symmetric "see also" links.

- [Prompty i kontekst (Prompting and context engineering)](https://aiatlasgraph.com/t/prompting.md)
- [Stopniowe wczytywanie umiejętności (Progressive disclosure of skills)](https://aiatlasgraph.com/t/skilldisclosure.md)

## Sources

- [Harness engineering: leveraging Codex in an agent-first world](<https://openai.com/index/harness-engineering/>) `openai-harness-2026` · by Ryan Lopopolo, OpenAI · sponsored

---

AI Atlas revision 122 (2026-10-30) · HTML: https://aiatlasgraph.com/t/harnessdocs · index: https://aiatlasgraph.com/llms.txt · everything: https://aiatlasgraph.com/llms-full.txt · updated 2026-10-30