Як читати файли Markdown, які пишуть твої ШІ-агенти

Агенти ШІ для програмування пишуть багато Markdown. План перед початком роботи. Специфікацію. Нотатки про те, що вони вирішили. Звіт, коли закінчують. Файли інструкцій, які вони читають, як-от AGENTS.md чи CLAUDE.md. Нерідко й файл пам’яті, який вони постійно доповнюють.

Усе це звичайний текст із #, ** і |. Його можна читати в редакторі коду, але довгі плани й таблиці там читаються важко, і легко пропустити те, що агент щойно змінив.

Ця сторінка про читання цих файлів: як чистих сторінок і так, щоб було видно, що змінилося.

Що пишуть агенти

ФайлЩо цеХто його пише
AGENTS.md, CLAUDE.mdІнструкції, які агент читає на початку кожного сеансуТи, часто за допомогою агента
Плани та специфікаціїЩо агент збирається створити, крок за крокомАгент, коли ти просиш план
Нотатки та рішенняЧому він щось зробив, що пробувавАгент
Звіти та підсумкиЩо він зробив, що лишилосяАгент, наприкінці завдання
Файли пам’ятіТе, що він дізнався про тебе і проєктДеякі агенти, самостійно

Сторінки про окремих агентів:

Три речі, які допомагають

1. Читай теку, а не один файл. Агенти пишуть багато файлів у різних теках. Відкрий всю теку проєкту в засобі читання Markdown, щоб можна було переходити між планом, специфікацією та звітом.

2. Дивись нові й змінені файли. Поки агент працює, файли з’являються й змінюються. Ти хочеш бачити, які саме, не відкриваючи кожен.

3. Дивись, що змінилося всередині файлу. Коли агент редагує уже прочитаний план, ти хочеш бачити лише те, що змінилося, а не читати весь план знову.

На Mac: PilcrowMD (бета)

PilcrowMD для Mac (бета) це безкоштовний засіб читання Markdown, створений саме для цього.

PilcrowMD для Mac (бета)

На телефоні: перевіряй роботу агента

Агенти не працюють на телефоні, але ти можеш прочитати те, що вони написали. Якщо тека агента синхронізується з Google Drive, додай її в розділ Мої теки в PilcrowMD для Android.

Перевірено з Google Drive і пам’яттю телефона. Інші хмарні застосунки можуть працювати, якщо вони показують свої теки у засобі вибору папок Android.

Поширені запитання

Чи потрібен PilcrowMD, щоб читати ці файли? Ні. Це звичайний текст; їх відкриє будь-який редактор. Засіб читання Markdown показує таблиці, код і заголовки як сторінку, що допомагає з довгими планами.

Чи змінить PilcrowMD файли мого агента? Ні, якщо ти не редагуєш й не зберігаєш. Інакше нічого не записується, а перед збереженням поверх зміни іншого застосунку він запитує.

Чи надсилає він мої файли кудись? Ні. Застосунок для Mac не встановлює інтернет-з’єднань, а застосунок для Android не має дозволу на доступ до інтернету. На Android синхронізацію виконує хмарний застосунок, обраний тобою, наприклад Google Drive.

Також для Mac: PilcrowMD для Mac (бета)