README-карта скоротила пошук файлів у Claude Code
Автор xda-developers попросив Claude Code побудувати ієрархію README.md для свого диска: головний плюс 7 менших README та CLAUDE.md з інструкцією спершу шукати через README. Перевірка підтвердила коректність усіх 309 посилань, виправивши 4 помилки.
У тесті з пошуком файлу labtask4.asm (назва нічого не казала про зміст) сесія з READMEs впоралась за 9 секунд, без них (з `--safe-mode`) — за 4 хв 20 с. У восьми тестах разом: 79 секунд з READMEs проти 382 без них.
Як Claude будував карту файлів
Автор запустив Claude Code у домашній директорії та попросив дослідити диск і побудувати ієрархію `README.md`. Claude сам визначив, які папки варті окремого опису, і запустив три паралельні агенти: один обстежував Desktop, другий — Downloads, третій — проєкти та Documents у домашній папці.
У процесі виявились нелогічні зв'язки між файлами: частина SQL-файлів із бази даних лежала в папці COAL — а це назва курсу з асемблера, не бази даних. Саме такі випадки роблять пошук файлів складним, коли орієнтуєшся лише на назву папки.
За підсумками розвідки Claude запропонував план — які папки отримають власний README, а які покриє загальний індекс. У результаті з'явилося 7 README-файлів (для Desktop, Downloads, Documents, курсу з асемблера та кількох хаотичних підпапок) і один `CLAUDE.md`. Останній не описує вміст, а дає інструкцію: спершу відкрити головний README, перейти за посиланням до потрібного піддерева й лише потім перевірити існування файлу перед відповіддю.
Перевірка та тест на labtask4.asm
Claude прогнав валідацію власної структури: спочатку знайшов 4 помилки в посиланнях, виправив їх і підтвердив коректність усіх 309 посилань і згадок файлів. Жоден існуючий файл при цьому не був переміщений чи перейменований.
Для тесту автор відкрив дві сесії з однаковою моделлю — Claude Sonnet 5.5. Другу запустив із прапорцем `--safe-mode`, який вимикає кастомізації: `CLAUDE.md`, skills, hooks, плагіни — щоб свіжостворена інструкція не впливала на обидві сесії одночасно.
Завдання — знайти асемблерну програму з меню банкомата (поповнення/знімання коштів), яка лежала у файлі `labtask4.asm` у папці DOS; назва файлу нічого не казала про зміст. Сесія з READMEs відкрила головний README, перейшла за посиланням до README папки DOS, звідти визначила потрібний файл і перевірила його вміст — усе за два shell-команди й 9 секунд. Сесія без READMEs шукала асемблерні файли по всій домашній директорії, спочатку відкрила не той файл, і витратила на пошук і перевірку 4 хвилини 20 секунд.
Де приріст менший і що з цим робити
У решті семи тестів із восьми переваги README були меншими, ніж у випадку з labtask4.asm — той тест виявився аномально довгим без READMEs і суттєво вплинув на підсумкові 79 секунд проти 382. В одному з восьми тестів результати сесій зійшлися.
Автор не став краще організовувати файли сам — система не замінює дисципліну, вона лише дає Claude Code карту того, що вже є. Тому прийом варто застосовувати до папок, які вже існують і відносно стабільні, а не як спосіб підтримувати порядок у процесі поточної роботи.
Що лишається нерозв'язаним
Автор прямо визнає: він ще не знайшов спосіб підтримувати систему README актуальною з часом — нові файли й хаотично названі папки неминуче з'являтимуться, і частина README застаріє. Точних формулювань промптів, якими він просив Claude будувати ієрархію й валідувати посилання, у матеріалі немає — лише описано, що саме він просив зробити.