Как записаться в библиотеку FPF. Инструкция для непрограммистов.
Берут тексты из библиотеки, а не берут библиотеку
В библиотеку приходят за текстами, которые нужны для своей работы. Чтобы получить пользу от библиотеки Конгресса, её не требуется читать целиком, "загружать", запоминать, загружать её полный каталог и т. д. С библиотекой FPF та же история: вы приходите в неё, а не "подгружаете её". Там чуть больше 32 MB уже, любая подгружалка "в контекст" LLM-модели или в живую голову путём "полного чтения" споткнётся о такие объёмы. Это примерно десять полных "Войн и миров", то есть сорок томов -- тут, пожалуйста, без иллюзий по поводу "прочту, освою". Так что запоминаем: в библиотеку ходят, в библиотеке что-то читают, про библиотеку FPF надо говорить примерно так же, как про библиотеку Конгресса: "пошёл, взял, не подошло, сходил ещё раз, взял другое". Да, в библиотеке есть и много ненужного вот прямо сейчас, есть даже не нужное никому и никогда -- как в любой библиотеке. Но есть и нужное позарез, причём нужное редко, но уж когда нужно -- то без него никуда, а без библиотеки брать будет неоткуда. В библиотеке FPF не столько "подборка из интернетов" (как в Википедии), сколько результаты методологического и концептуального синтеза лучших методов решения затруднений, поэтому не всё оттуда можно погуглить в других местах.
В любом случае культурные люди и агенты работают не только с тем, что могут вспомнить "из головы", они ходят в библиотеку и берут оттуда тексты для своей работы. Но не берут саму библиотеку (хотя "берут почты и телеграфы" в ходе революций, города в ходе войн): "взял библиотеку Конгресса", "взял библиотеку FPF" -- так не говорят, мы тут не воюем. Взяли из библиотеки нужное, почитали, почесали (кремниевый или кожаный) затылок, затем вернулись к своим размышлениям и делам -- но обогащённые новыми знаниями. Если вы достаточно умны, то вы эти знания используете, если не умны -- будете просто эрудитом, начитанным, вечно подающим надежды.
В FPF Library собраны разные "фреймворки" (руководства, справочники, формальный перевод тут -- "концептуальные основы"), которые делаются на базе ядра методов мышления, исходящих из первых принципов: First Principles Framework. Дальше идут предметные (domain) фреймворки принципов отдельных дисциплин -- Domain Principles Framework (DPF), вроде Operations Management Principles Framework или Human Capability Development Principles Framework. Можно сходить в библиотеку этих принципов мышления и действия (FPF Library), порыться в библиотечном фонде и вытащить то, что интересно: описания методов подготовки понятного объяснения, организации обучения и выбора способа получить инженерный результат. Есть описания методов подготовки танцевальных выступлений, удержания культуры в сообществе, математического моделирования. В библиотеке FPF содержатся более-менее универсальные описания каких-то самых общих методов решения самых общих проблем, причём эти методы базируются на каких-то фундаментальных основаниях, они "из первых принципов". Если у вас есть какое-то затруднение, то можете попробовать сходить в библиотеку FPF (ну, или библиотеку Конгресса): с большой долей вероятности вы вытащите из этой библиотеки описание метода, которое снимает ваше затруднение, даёт для него решение. При этом в библиотеке FPF описаны не только методы, но и связи между ними -- там есть и справочники (References). И ещё в библиотеке FPF описывались не все подряд методы (как в библиотеке Конгресса), а только самые-самые общие, которые есть шанс использовать часто. Так что вероятность того, что нужный вам метод в библиотеке описан, велика.
Читательский стол и книжные полки
Представьте "контекст" (тот самый, который "быстро заканчивается", который сжимают, которого "не хватает" и т. д.) ИИ-агента как читательский стол. На нём помещаются ваше задание агенту, материалы для его текущей работы и её промежуточные результаты. Сама библиотека FPF остаётся на полках, а не выгружается на этот стол: она продолжает находиться на сайте в интернете или в вашей компьютерной папке с файлами. Агент обращается к ней, когда ему нужен следующий текст, и кладёт на свой рабочий стол ("контекст") только нужное, часто даже не весь текст целиком, а только нужный кусочек текста. Как найдёт? Агенты очень хорошо умеют искать, лучше вас. Вас не должно это заботить (а если вы программист, то даже программисты удивляются, как хорошо ищут агенты самыми простыми средствами, безо всяких skills, "установщиков пакетов", MCP и т. д. -- посмотрите замеры вот тут: https://systemsworld.club/t/agent-skills-kak-format-doneseniya-metoda-raboty-do-ii-agenta/41439/6, но это интересно будет именно программистам. Подробности у меня в чате, огромная дискуссия, начиная с https://t.me/ailev_blog_discussion/37986).
Общий объём библиотеки не обязан помещаться в контекст агента, а библиотеку эту необязательно читать -- читаются оттуда только отдельные тексты, которые надо будет найти. Для исправления в одном абзаце вашего документа вам может понадобиться один раздел какого-то описания метода исправления. Для сложного решения потребуются несколько связанных описаний методов. В библиотеке FPF лежат "паттерны" -- описания тех или иных методов, хорошо структурированные. Можно взять одну секцию паттерна с частью описания какого-то метода, можно вытащить целый паттерн, можно вытащить даже несколько паттернов! Но уж точно не надо тащить полбиблиотеки. Выбирают тексты по имеющемуся у вас рабочему или личному затруднению, даже не по решению: вы ведь при обращении в библиотеку про проблему уже что-то знаете, а вот про решение -- ещё нет. Полнотекстовый поиск и чтение "пока не найдёшь" (как обычно! Никаких чудес!) позволяют вытаскивать нужные тексты по мере необходимости, а не впрок. Вы найдёте эти нужные тексты медленно, а ваш агент -- за миллисекунды, проверено и нашими тестами, и многочисленными не нашими.
На рисунке показаны три способа взять текст из библиотеки:
* самому найти текст на сайте библиотеки https://fpf.tools (там есть полнотекстовый поиск). Впрочем, умный AI-агент это тоже может сделать. Это через интернет.
* поручить поиск и чтение ИИ-агенту по специальному компьютерному протоколу (людям это недоступно, агенты такое, наоборот, любят). Это с того же сайта fpf.tools, через интернет -- "служебный вход для умных, но не очень живых" (MCP).
* взять копию всех файлов библиотеки на сайте хранилища https://github.com/ailev/FPF для того, чтобы AI-агенты (а не вы) брали нужные им тексты на вашем компьютере. Это уже будет без интернета, самое быстрое.
Все три способа приведут к одним и тем же текстам, причём сайт fpf.tools и его MCP дают доступ к самой свежей автоматически обновляемой версии. GitHub тоже даст вам скачать свежую версию -- но она будет у вас свежей только на момент скачивания, для освежения её надо будет перескачать заново: файлы, увы, не перескачиваются сами по себе. Обновления Библиотеки часты: несколько раз в сутки, поэтому с файлами работать будет быстрее, а с сайтом через интернет -- свежее. Выбирайте.
Внизу рисунка показан файл USING-FPF.md: https://fpf.tools/library/USING-FPF. Это инструкция для посетителя библиотеки и его AI-агента. Она объясняет, как искать нужное описание метода (паттерн), читать условия его применения и работать со связанными источниками. Расширение .md означает обычный текстовый файл с разметкой Markdown; на сайте fpf.tools этот текст уже показан в удобном для чтения виде. Все тексты библиотеки FPF на английском и на довольно заумном языке, но вы всегда можете попросить вашего агента рассказать всё вам попроще на русском, а также не использовать никаких других слов, кроме вам известных слов из вашей любимой предметной области.
Дайте ИИ-агенту доступ к USING-FPF.md одним из способов ниже и попросите прочитать эту инструкцию. Затем опишите, что хотите получить. Например: «У меня инструкция для новых сотрудников. После её чтения они должны самостоятельно передать согласованную заявку на закупку. Найди метод, который поможет убрать двусмысленности, и подготовь исправленный текст».
В библиотеке методы описаны в паттернах. Паттерн объясняет повторяющуюся проблему, условия её возникновения и способ с ней работать. У него есть короткий идентификатор, например F.19. Это удобный адрес: по нему вы или агент можете снова открыть нужный текст. На сайте этот адрес будет выглядеть как https://fpf.tools/F.19 -- и по этому адресу будет полный текст паттерна "F.19 - Ontology-First Plain Technical Rewriting". Опытные инженеры-менеджеры могут даже сказать: "Вот мой текст, проверь его по F.19" -- дальше AI-агент сам найдёт этот F.19 и почистит ваш текст от двусмысленностей.
Первый способ: найти паттерн самому на сайте
На левой части рисунка читатель сам выбирает книгу. Так можно работать с сайтом https://fpf.tools.
1. Откройте https://fpf.tools/start, затем перейдите к поиску на https://fpf.tools/search.
2. Введите слова, описывающие вашу задачу. Публикации преимущественно английские, поэтому для нашего примера подойдёт запрос plain technical rewriting. ИИ-агенту можно поручить подобрать английские слова по вашему русскому описанию или даже самому поискать на этом сайте. Поиск на сайте сам запросы не переводит, он для англоязычной аудитории.
3. Откройте найденный паттерн и прочитайте, для каких случаев он предназначен. Для редактирования неясного текста подходит F.19; его можно сразу открыть по адресу https://fpf.tools/F.19. Посмотрите, что там в какой ситуации предлагается сделать.
4. Если хотите продолжить работу с ИИ-агентом без подключения к библиотеке (не хотите "записать в библиотеку" агента, а сами будете всё смотреть на сайте), раскройте строчку "Source and sharing" -- там будут кнопки копирования или ссылки, или текста. Передайте ссылку или текст (текста в паттерне F.19 много, он даже не поместится на страницу, но вы справитесь -- этот сайт не только для AI-агентов, он и для людей тоже). Таким же способом передайте USING-FPF.md, это будет инструкция вашему агенту, как и что искать внутри паттернов -- как устроена там разметка.
Результат поиска по паттернам (строка поиска будет на первой странице сайта) похож на каталожную карточку: он помогает выбрать, что открыть. Ищите как в Гугле: смотрите, что нашли, пробуйте какие-то другие слова, опять смотрите.
Второй способ: записать в библиотеку ИИ-агента ("подключить по MCP")
В центре рисунка ИИ-агент приносит выбранные книги. Чтобы он мог самостоятельно искать и читать описания методов на fpf.tools не как человек (пользуясь полнотекстовым поиском, листая страницы), а как AI-агент (это для него будет быстрее и удобнее), надо его "записать в библиотеку", на языке программистов это "подключить через MCP". После подключения вы описываете задачу по-русски, а агент обращается к библиотеке за источниками по-английски. Это не самый быстрый и не самый эффективный способ, но он очень удобный! Чуть дороже, но с комфортом -- принцип поездки на такси, а не на общественном транспорте или собственной машине.
Адрес сервера, который надо знать агенту: https://mcp.fpf.tools/mcp. Сервер общедоступен, отдельный пароль или API-ключ для него не нужен. Он предоставляет опубликованные материалы библиотеки, всегда свежие. На входе -- поисковый запрос, на выходе -- результаты поиска, агент сам разбирается со всеми техническими подробностями.
Если у вас есть любимый AI-агент, то инструкция по записи его в библиотеку FPF находится по адресу https://fpf.tools/connect. Находите вариант инструкции по подключению для вашего ChatGPT, Claude или ещё какого, подключаете.
Первое обращение можно сформулировать так:
«Используй инструменты FPF Library. Узнай, какая редакция библиотеки сейчас доступна, назови несколько публикаций и прочитай USING-FPF.md. Затем помоги мне решить следующую задачу: …».
В ответе должны появиться сведения, полученные из библиотеки, и ссылки на источники. Если агент сообщает, что инструменты недоступны, проверьте, выбран ли плагин в этом разговоре. Получив доступ к текстам, переходите к своей задаче.
Третий способ: взять копию всех файлов на свой компьютерный диск (чуть больше 30 MB)
Справа на рисунке читатель уносит книги. Файлы библиотеки можно взять по адресу https://github.com/ailev/FPF и работать с ними в приложении, которое умеет искать и читать файлы, например в Codex. Это, как ни странно, самый быстрый и эффективный способ (программисты обычно этому не верят, а зря: это легко измерить, и эти замеры делали не только мы. Одну из ссылок на эту тему мы тут уже приводили).
Для скачивания откройте меню Code на странице GitHub и выберите Download ZIP. Распакуйте архив. Файлы и подпапки оставьте на своих местах, чтобы сохранить ссылки между публикациями. USING-FPF.md находится в корне архива, а состав опубликованной библиотеки описан в Readme.md.
Дайте агенту доступ к распакованной папке. Поручите прочитать USING-FPF.md и выполнить вашу задачу по опубликованным материалам, перечисленным в Readme.md. Если приложение поддерживает инструкции проекта, укажите там, что при работе с FPF нужно пользоваться USING-FPF.md.
Папка с файлами служит "домашним книжным шкафом" для этих сорока томиков "Войны и мира". Агенту нужны поиск по его содержимому и возможность читать найденные места -- он будет использовать для этого программу rg, которая будет работать с регулярными выражениями, и это (поверьте!) очень быстро и эффективно. Более быстро и эффективно, чем всё остальное.
Загружать содержимое всех файлов в один разговор не требуется. Если ваше AI-приложение работает только с "вложениями" (аттачами), это беда: вам проще поменять приложение, чем сообразить, что именно из библиотеки FPF надо подцепить, чтобы там оказалось ровно то описание метода, которое вам нужно -- паттерны, описывающие методы, плотно перевязаны друг с другом. Работа с одним паттерном редка (даже F.19 при его применении при оставшихся смысловых проблемах будет подтаскивать E.10, а тот -- ещё кучу всего), вытащить несколько нужных "руками" и подцепить в чат вы не сможете. Но агенты поумнее и побыстрее: они могли бы использовать поиск на диске, которого у вас в вашем приложении как раз и нет! Беда.
Скачанная копия сама не обновляется. Когда понадобится новая версия библиотеки FPF, скачайте её с того же https://github.com/ailev/FPF.
Если вы получили сообщение от агента, что он прочёл только самое начало FPF и остановился -- тут что-то не так. Проверьте, что вы дали ему почитать и исполнить инструкцию USING-FPF.md, там начало инструкции больше для людей, а вот конец -- для агентов. Эта инструкция не очень большая, примерно 10K знаков.
Первый поход в библиотеку: принести что-нибудь полезное
Продолжим пример с инструкцией для сотрудников. Вы уже знаете, где лежит паттерн F.19 (в библиотеке -- или на сайте, или у вас на диске) и как дать агенту доступ к нему. Теперь поручите агенту использовать библиотеку FPF в вашей работе:
"Используй FPF Library и инструкцию USING-FPF.md" -- это надо будет говорить в каждом разговоре, или самые ушлые запишут это в своих Claude или Codex куда-нибудь в AGENTS.md, или как это у них там называется (везде по-разному, увы) -- это тот файл, который агент будет обязательно читать перед началом работы, хотя и не при каждом отдельном ответе (поэтому при длинном разговоре поглядеть нужное в библиотеке FPF он может и забыть). В инструкции USING-FPF.md всё это написано, причём более подробно, примерно так: "не используй специфического сленга FPF, говори на языке той работы, которой мы тут занимаемся". Опытные пользователи почему-то эту инструкцию поправляют: убирают "не используй специфический сленг FPF", потому как на таком сленге проще обсуждать важные проблемы, проще понять (ну, если вы попросите интегралы и дифференциалы обсуждать на простом языке, без специфического сленга математиков -- так тоже можно, но опытные математики почему-то так не делают).
Дальше, как обычно, промпты (да, можно вот так неформально, мы не в Оксфорде или Гарварде): "Эта инструкция предназначена для нового сотрудника: после чтения он должен понять, что сделать, кому передать результат и как проверить готовность. Сохрани установленные сроки и условия. Если для исправления не хватает фактов, спроси о тех, от которых зависит действие. Верни исправленный текст по-русски и коротко поясни, что ты там исправил и почему". Если вы всё сделали правильно -- сразу заметите присутствие паттернов FPF в работе вашего агента. Люди поопытней могут просто сказать: "Вот инструкция для нового сотрудника, прогони текст по F.19" -- и если там есть двусмысленности, то вам их исправят.
Скажем, текст: “После согласования подготовьте материалы и передайте ответственному. Перед отправкой проверьте, что всё готово”. Здесь агенту потребуется выяснить, что согласуют, какие материалы нужно подготовить, кто их получает и что означает готовность. Библиотека даёт метод работы с неясным текстом. Факты о вашей организации сообщаете вы.
Предположим, в этой фразе вы имели в виду, что руководитель согласует заявку на закупку. Подготовка означает собрать два документа: эту заявку и коммерческое предложение поставщика. Получатель документов — специалист по закупкам. Перед отправкой нужно проверить, что заявка подписана руководителем, а срок действия предложения ещё не истёк. Тогда исправленная AI-агентом инструкция может выглядеть так: «После того как руководитель согласует заявку на закупку, соберите заявку и коммерческое предложение поставщика. Проверьте, что заявка подписана руководителем, а срок действия предложения ещё не истёк. Затем отправьте оба документа специалисту по закупкам».
Дальше как обычно: надо проверить, что там написал AI-агент, даже если он пользовался библиотекой FPF: на Аллаха надейся, а верблюда -- привязывай! Как вы считаете, достаточно ли сотруднику этих указаний, если это именно ваша ситуация?
Начните с одного вопроса, который вам действительно нужно решить. Сходите на сайт сами (это редко, но и люди читают паттерны в библиотеке FPF), поручите ходить туда AI-агенту или работайте с копией файлов библиотеки. Библиотекой пользуются именно так: приходят с вопросом, берут подходящие тексты, читают необходимое и используют прочитанное. Потом опять идут в библиотеку, и так всю жизнь.
На рисунке показаны три способа взять текст из библиотеки:
* самому найти текст на сайте библиотеки https://fpf.tools (там есть полнотекстовый поиск). Впрочем, умный AI-агент это тоже может сделать. Это через интернет.
* поручить поиск и чтение ИИ-агенту по специальному компьютерному протоколу (людям это недоступно, агенты такое, наоборот, любят). Это с того же сайта fpf.tools, через интернет -- "служебный вход для умных, но не очень живых" (MCP).
* взять копию всех файлов библиотеки на сайте хранилища https://github.com/ailev/FPF для того, чтобы AI-агенты (а не вы) брали нужные им тексты на вашем компьютере. Это уже будет без интернета, самое быстрое.
Все три способа приведут к одним и тем же текстам, причём сайт fpf.tools и его MCP дают доступ к самой свежей автоматически обновляемой версии. GitHub тоже даст вам скачать свежую версию -- но она будет у вас свежей только на момент скачивания, для освежения её надо будет перескачать заново: файлы, увы, не перескачиваются сами по себе. Обновления Библиотеки часты: несколько раз в сутки, поэтому с файлами работать будет быстрее, а с сайтом через интернет -- свежее. Выбирайте.
Внизу рисунка показан файл USING-FPF.md: https://fpf.tools/library/USING-FPF. Это инструкция для посетителя библиотеки и его AI-агента. Она объясняет, как искать нужное описание метода (паттерн), читать условия его применения и работать со связанными источниками. Расширение .md означает обычный текстовый файл с разметкой Markdown; на сайте fpf.tools этот текст уже показан в удобном для чтения виде. Все тексты библиотеки FPF на английском и на довольно заумном языке, но вы всегда можете попросить вашего агента рассказать всё вам попроще на русском, а также не использовать никаких других слов, кроме вам известных слов из вашей любимой предметной области.
Дайте ИИ-агенту доступ к USING-FPF.md одним из способов ниже и попросите прочитать эту инструкцию. Затем опишите, что хотите получить. Например: «У меня инструкция для новых сотрудников. После её чтения они должны самостоятельно передать согласованную заявку на закупку. Найди метод, который поможет убрать двусмысленности, и подготовь исправленный текст».
В библиотеке методы описаны в паттернах. Паттерн объясняет повторяющуюся проблему, условия её возникновения и способ с ней работать. У него есть короткий идентификатор, например F.19. Это удобный адрес: по нему вы или агент можете снова открыть нужный текст. На сайте этот адрес будет выглядеть как https://fpf.tools/F.19 -- и по этому адресу будет полный текст паттерна "F.19 - Ontology-First Plain Technical Rewriting". Опытные инженеры-менеджеры могут даже сказать: "Вот мой текст, проверь его по F.19" -- дальше AI-агент сам найдёт этот F.19 и почистит ваш текст от двусмысленностей.
Первый способ: найти паттерн самому на сайте
На левой части рисунка читатель сам выбирает книгу. Так можно работать с сайтом https://fpf.tools.
1. Откройте https://fpf.tools/start, затем перейдите к поиску на https://fpf.tools/search.
2. Введите слова, описывающие вашу задачу. Публикации преимущественно английские, поэтому для нашего примера подойдёт запрос plain technical rewriting. ИИ-агенту можно поручить подобрать английские слова по вашему русскому описанию или даже самому поискать на этом сайте. Поиск на сайте сам запросы не переводит, он для англоязычной аудитории.
3. Откройте найденный паттерн и прочитайте, для каких случаев он предназначен. Для редактирования неясного текста подходит F.19; его можно сразу открыть по адресу https://fpf.tools/F.19. Посмотрите, что там в какой ситуации предлагается сделать.
4. Если хотите продолжить работу с ИИ-агентом без подключения к библиотеке (не хотите "записать в библиотеку" агента, а сами будете всё смотреть на сайте), раскройте строчку "Source and sharing" -- там будут кнопки копирования или ссылки, или текста. Передайте ссылку или текст (текста в паттерне F.19 много, он даже не поместится на страницу, но вы справитесь -- этот сайт не только для AI-агентов, он и для людей тоже). Таким же способом передайте USING-FPF.md, это будет инструкция вашему агенту, как и что искать внутри паттернов -- как устроена там разметка.
Результат поиска по паттернам (строка поиска будет на первой странице сайта) похож на каталожную карточку: он помогает выбрать, что открыть. Ищите как в Гугле: смотрите, что нашли, пробуйте какие-то другие слова, опять смотрите.
Второй способ: записать в библиотеку ИИ-агента ("подключить по MCP")
В центре рисунка ИИ-агент приносит выбранные книги. Чтобы он мог самостоятельно искать и читать описания методов на fpf.tools не как человек (пользуясь полнотекстовым поиском, листая страницы), а как AI-агент (это для него будет быстрее и удобнее), надо его "записать в библиотеку", на языке программистов это "подключить через MCP". После подключения вы описываете задачу по-русски, а агент обращается к библиотеке за источниками по-английски. Это не самый быстрый и не самый эффективный способ, но он очень удобный! Чуть дороже, но с комфортом -- принцип поездки на такси, а не на общественном транспорте или собственной машине.
Адрес сервера, который надо знать агенту: https://mcp.fpf.tools/mcp. Сервер общедоступен, отдельный пароль или API-ключ для него не нужен. Он предоставляет опубликованные материалы библиотеки, всегда свежие. На входе -- поисковый запрос, на выходе -- результаты поиска, агент сам разбирается со всеми техническими подробностями.
Если у вас есть любимый AI-агент, то инструкция по записи его в библиотеку FPF находится по адресу https://fpf.tools/connect. Находите вариант инструкции по подключению для вашего ChatGPT, Claude или ещё какого, подключаете.
Первое обращение можно сформулировать так:
«Используй инструменты FPF Library. Узнай, какая редакция библиотеки сейчас доступна, назови несколько публикаций и прочитай USING-FPF.md. Затем помоги мне решить следующую задачу: …».
В ответе должны появиться сведения, полученные из библиотеки, и ссылки на источники. Если агент сообщает, что инструменты недоступны, проверьте, выбран ли плагин в этом разговоре. Получив доступ к текстам, переходите к своей задаче.
Третий способ: взять копию всех файлов на свой компьютерный диск (чуть больше 30 MB)
Справа на рисунке читатель уносит книги. Файлы библиотеки можно взять по адресу https://github.com/ailev/FPF и работать с ними в приложении, которое умеет искать и читать файлы, например в Codex. Это, как ни странно, самый быстрый и эффективный способ (программисты обычно этому не верят, а зря: это легко измерить, и эти замеры делали не только мы. Одну из ссылок на эту тему мы тут уже приводили).
Для скачивания откройте меню Code на странице GitHub и выберите Download ZIP. Распакуйте архив. Файлы и подпапки оставьте на своих местах, чтобы сохранить ссылки между публикациями. USING-FPF.md находится в корне архива, а состав опубликованной библиотеки описан в Readme.md.
Дайте агенту доступ к распакованной папке. Поручите прочитать USING-FPF.md и выполнить вашу задачу по опубликованным материалам, перечисленным в Readme.md. Если приложение поддерживает инструкции проекта, укажите там, что при работе с FPF нужно пользоваться USING-FPF.md.
Папка с файлами служит "домашним книжным шкафом" для этих сорока томиков "Войны и мира". Агенту нужны поиск по его содержимому и возможность читать найденные места -- он будет использовать для этого программу rg, которая будет работать с регулярными выражениями, и это (поверьте!) очень быстро и эффективно. Более быстро и эффективно, чем всё остальное.
Загружать содержимое всех файлов в один разговор не требуется. Если ваше AI-приложение работает только с "вложениями" (аттачами), это беда: вам проще поменять приложение, чем сообразить, что именно из библиотеки FPF надо подцепить, чтобы там оказалось ровно то описание метода, которое вам нужно -- паттерны, описывающие методы, плотно перевязаны друг с другом. Работа с одним паттерном редка (даже F.19 при его применении при оставшихся смысловых проблемах будет подтаскивать E.10, а тот -- ещё кучу всего), вытащить несколько нужных "руками" и подцепить в чат вы не сможете. Но агенты поумнее и побыстрее: они могли бы использовать поиск на диске, которого у вас в вашем приложении как раз и нет! Беда.
Скачанная копия сама не обновляется. Когда понадобится новая версия библиотеки FPF, скачайте её с того же https://github.com/ailev/FPF.
Если вы получили сообщение от агента, что он прочёл только самое начало FPF и остановился -- тут что-то не так. Проверьте, что вы дали ему почитать и исполнить инструкцию USING-FPF.md, там начало инструкции больше для людей, а вот конец -- для агентов. Эта инструкция не очень большая, примерно 10K знаков.
Первый поход в библиотеку: принести что-нибудь полезное
Продолжим пример с инструкцией для сотрудников. Вы уже знаете, где лежит паттерн F.19 (в библиотеке -- или на сайте, или у вас на диске) и как дать агенту доступ к нему. Теперь поручите агенту использовать библиотеку FPF в вашей работе:
"Используй FPF Library и инструкцию USING-FPF.md" -- это надо будет говорить в каждом разговоре, или самые ушлые запишут это в своих Claude или Codex куда-нибудь в AGENTS.md, или как это у них там называется (везде по-разному, увы) -- это тот файл, который агент будет обязательно читать перед началом работы, хотя и не при каждом отдельном ответе (поэтому при длинном разговоре поглядеть нужное в библиотеке FPF он может и забыть). В инструкции USING-FPF.md всё это написано, причём более подробно, примерно так: "не используй специфического сленга FPF, говори на языке той работы, которой мы тут занимаемся". Опытные пользователи почему-то эту инструкцию поправляют: убирают "не используй специфический сленг FPF", потому как на таком сленге проще обсуждать важные проблемы, проще понять (ну, если вы попросите интегралы и дифференциалы обсуждать на простом языке, без специфического сленга математиков -- так тоже можно, но опытные математики почему-то так не делают).
Дальше, как обычно, промпты (да, можно вот так неформально, мы не в Оксфорде или Гарварде): "Эта инструкция предназначена для нового сотрудника: после чтения он должен понять, что сделать, кому передать результат и как проверить готовность. Сохрани установленные сроки и условия. Если для исправления не хватает фактов, спроси о тех, от которых зависит действие. Верни исправленный текст по-русски и коротко поясни, что ты там исправил и почему". Если вы всё сделали правильно -- сразу заметите присутствие паттернов FPF в работе вашего агента. Люди поопытней могут просто сказать: "Вот инструкция для нового сотрудника, прогони текст по F.19" -- и если там есть двусмысленности, то вам их исправят.
Скажем, текст: “После согласования подготовьте материалы и передайте ответственному. Перед отправкой проверьте, что всё готово”. Здесь агенту потребуется выяснить, что согласуют, какие материалы нужно подготовить, кто их получает и что означает готовность. Библиотека даёт метод работы с неясным текстом. Факты о вашей организации сообщаете вы.
Предположим, в этой фразе вы имели в виду, что руководитель согласует заявку на закупку. Подготовка означает собрать два документа: эту заявку и коммерческое предложение поставщика. Получатель документов — специалист по закупкам. Перед отправкой нужно проверить, что заявка подписана руководителем, а срок действия предложения ещё не истёк. Тогда исправленная AI-агентом инструкция может выглядеть так: «После того как руководитель согласует заявку на закупку, соберите заявку и коммерческое предложение поставщика. Проверьте, что заявка подписана руководителем, а срок действия предложения ещё не истёк. Затем отправьте оба документа специалисту по закупкам».
Дальше как обычно: надо проверить, что там написал AI-агент, даже если он пользовался библиотекой FPF: на Аллаха надейся, а верблюда -- привязывай! Как вы считаете, достаточно ли сотруднику этих указаний, если это именно ваша ситуация?
Начните с одного вопроса, который вам действительно нужно решить. Сходите на сайт сами (это редко, но и люди читают паттерны в библиотеке FPF), поручите ходить туда AI-агенту или работайте с копией файлов библиотеки. Библиотекой пользуются именно так: приходят с вопросом, берут подходящие тексты, читают необходимое и используют прочитанное. Потом опять идут в библиотеку, и так всю жизнь.