agents . md

Когда пишешь код в Cursor или Windsurf, часто сталкиваешься с тем, что AI не понимает структуру проекта или продолжает использовать устаревшие команды сборки. В итоге сгенерированный код просто не запускается.

Причина в том, что README.md по сути пишется для людей. В нем полно контекста, который человек понимает автоматически, но для модели он расплывчат и неполон — там нет точных инструкций для выполнения.

Недавно на GitHub я наткнулся на проект AGENTS.md — это опенсорс, цель которого дать AI-программным агентам отдельную «инструкцию по эксплуатации».

Идея в том, чтобы четко разделить гайд для людей (quickstart, описание логики), и набор машинных инструкций по сборке, запуску тестов и кодстайлу. Они не мешают друг другу.

Логика очень простая: в корне проекта создается Markdown-файл, который явно объясняет AI, как собирать проект, как его тестировать и каким правилам оформления кода следовать.

Подход совместим с большинством современных AI-инструментов для разработки — VS Code, Cursor, Windsurf, Aider, GitHub Copilot и др.

Порог входа минимальный: достаточно создать файл AGENTS.md, вписать туда краткий обзор проекта, команды для тестов и важные замечания по безопасности.

В больших проектах можно раскладывать такие файлы по разным поддиректориям. AI будет автоматически читать ближайший по пути конфиг, что делает схему довольно гибкой.

По мере того как AI-ассистенты становятся стандартным инструментом разработки, наличие отдельной «машинной документации» может стать базовым навыком для каждого разработчика. Лучше начать пробовать уже сейчас.

📁 Language: #TypeScript 94.3%

⭐️ Stars: 9.9k

➡️ Cсылка на GitHub

📱 @git_developer

open-scouts

Если хочется отслеживать свежие опенсорс-проекты, движения по конкретным технологиям или хотя бы цены на какой-то товар, постоянно руками обновлять страницы, тупо трата времени. А если не следить, есть риск пропустить что-то важное.

Как раз на GitHub нашёлся опенсорс Open Scouts. По сути, это способ развернуть себе отряд AI-скаутов, которые круглосуточно шарят по интернету и мониторят нужную тебе инфу.

Поддерживаются кастомные задачи мониторинга: хочешь — ищешь новые рестораны рядом, хочешь, трекаешь новости по AI-индустрии. Всё можно повесить на расписание и гонять по крону автоматически.

Дальше подключается ИИ: он разбирает результаты поиска, собирает их в краткую выжимку в одну фразу и сразу шлёт всё это тебе на почту.

Проект построен на базе Next.js 16 и Supabase, для парсинга и обхода страниц интегрирован Firecrawl, есть Docker для развёртывания в один шаг, все данные при этом остаются у тебя.

Такая модель "повесил и забыл, дальше всё мониторит само" выглядит очень практичной, если нужно долго держать в фокусе какой-то рынок или область, но при этом не хочется тонуть в потоке мусорных обновлений.

📁 Language: #TypeScript 95.5%

⭐️ Stars: 586

➡️ Cсылка на GitHub

📱 @git_developer