Od README.md do PROGRAM.md: Markdown jako kod

Przez 22 lata Markdown był formatem dokumentacji. Pisałeś README, wpisy blogowe i notatki. Wyjaśniało to rzeczy ludziom.

Potem coś się zmieniło. W 2024 roku asystenci kodowania AI zaczęli czytać .cursorrules i copilot-instructions.md. W 2025 roku AGENTS.md pojawił się jako powszechny standard. Na początku 2026 roku Andrej Karpathy wydał autoresearch, gdzie cały ludzki wkład to plik Markdown o nazwie program.md.

Ewolucja jest jasna:

EraPlikOdbiorcyCel
2004-2023README.mdLudzieDokumentacja
2024.cursorrulesNarzędzia AI do kodowaniaZasady stylu kodu
2025AGENTS.mdAgenci AI do kodowaniaInstrukcje projektowe
2026program.mdAutonomiczne agentyProgramy badawcze

Markdown to już nie tylko dokumentacja. To język programowania dla AI.

Trzy generacje

Generacja 1: Dokumentacja (README.md)

Oryginalny przypadek użycia Markdown. Piszesz README, aby pomóc ludziom zrozumieć Twój projekt. Jest pasywny — leży tam, dopóki człowiek go nie przeczyta. Żadna maszyna na nim nie działa.

Generacja 2: Konfiguracja (AGENTS.md, CLAUDE.md)

Asystenci kodowania AI potrzebują kontekstu projektu. AGENTS.md informuje ich o Twoich poleceniach budowania, konwencjach kodowania i decyzjach architektonicznych. CLAUDE.md dostosowuje zachowanie Claude Code. Te pliki są aktywne — AI je czyta i odpowiednio zmienia swoje zachowanie.

Ale człowiek nadal pisze kod. Plik Markdown tylko pomaga AI lepiej asystować.

Generacja 3: Programowanie (program.md)

Z autoresearch człowiek w ogóle nie pisze kodu. Cały wkład to program.md — plik Markdown, który definiuje cele badawcze, ograniczenia i strategię. Agent AI czyta go, a następnie autonomicznie pisze, uruchamia i iteruje kod przez godziny lub dni.

To jest Markdown jako język programowania. Wynikiem nie jest sformatowany tekst — to działający kod, wyniki eksperymentów i odkrycia naukowe.

Dlaczego Markdown?

Dlaczego wszystkie systemy AI zbiegły się na Markdown zamiast, powiedzmy, YAML, JSON czy niestandardowego DSL?

Jest w danych treningowych. LLM-y widziały miliardy plików Markdown podczas treningu. Głęboko rozumieją jego konwencje — nagłówki wskazują hierarchię, punkty listy wskazują listy, bloki kodu wskazują zawartość wykonywalną.

Jest elastyczny. Markdown nie narzuca sztywnego schematu. Możesz pisać swobodne instrukcje, ustrukturyzowane tabele, przykłady kodu i język naturalny w tym samym pliku. Ta elastyczność pasuje do sposobu, w jaki ludzie myślą o kierowaniu agentami AI.

Jest audytowalny. Możesz przeczytać program.md i dokładnie zrozumieć, co agent dostaje do zrobienia. Spróbuj z 500-wierszową konfiguracją YAML.

Jest kontrolowany wersją. Każda zmiana instrukcji agenta to commit gita. Możesz porównywać, przeglądać i cofać zmiany zachowania agenta tak samo jak zmiany kodu.

Co to oznacza dla Ciebie

Jeśli Markdown staje się językiem programowania, każdy kto pisze Markdown staje się w pewnym sensie programistą. Umiejętność to nie składnia — to jasność myśli i precyzja instrukcji.

Oto co ma teraz znaczenie:

Naucz się pisać precyzyjne instrukcje Markdown. Im lepszy Twój AGENTS.md lub program.md, tym lepiej działa Twój agent AI. To nowa umiejętność łącząca wiedzę techniczną z jasnym pisaniem.

Zbuduj bibliotekę referencyjną w Markdown. Pisząc instrukcje dla agentów AI, potrzebujesz materiałów referencyjnych: dokumentacji, przykładów, prac, najlepszych praktyk. Posiadanie tych materiałów w czystym formacie Markdown sprawia, że są natychmiast użyteczne.

Zrozum ekosystem Markdown dla AI. Poznaj różnicę między AGENTS.md, CLAUDE.md, llms.txt i program.md. Każdy służy innemu celowi w rosnącym stosie Markdown dla AI.

Przechwytywanie wiedzy do instrukcji agentów

Pisanie dobrych instrukcji dla agentów AI wymaga wiedzy. Musisz rozumieć domenę, narzędzia, ograniczenia i cele. Wiele z tej wiedzy żyje w internecie — w stronach dokumentacji, wpisach blogowych, pracach badawczych i poradnikach.

Minibase konwertuje dowolne z tych źródeł internetowych na czysty Markdown jednym kliknięciem. Tworząc program.md lub AGENTS.md, posiadanie materiałów referencyjnych już w Markdown oznacza, że możesz je od razu cytować, referencjonować i na nich budować.

Badacze piszący najlepsze pliki program.md nie zaczynają od zera. Budują na wiedzy, którą zebrali i zorganizowali w formacie Markdown.


Minibase konwertuje dowolną stronę internetową na czysty Markdown — idealny do budowania biblioteki referencyjnej potrzebnej do pisania skutecznych instrukcji dla agentów AI. Wypróbuj Minibase za darmo.

Continue reading

Gotowy, aby zapisywać mądrzej?

Konwertuj dowolną stronę internetową na Markdown jednym kliknięciem.

Dodaj do Chrome