🤖 Что происходит, когда вы просто пишете «act as a senior developer»
Модель выдает рабочий код. Примерно рабочий. 😅
Компонент рендерится, но стили будут серым Tailwind по умолчанию. Про тесты модель скажет «добавлю позже». Переменные окажутся захардкожены, а в коде останется console.log.
Это не проблема модели. Это проблема инструкции. Нейросеть делает ровно то, о чем ее попросили, не проявляя инициативы. 🤷♂️
🔍 Откуда берется хороший системный промпт
Я потратил несколько недель на разбор структуры лучших открытых репозиториев с агентными конфигурациями. Их шесть, все под лицензиями MIT или Apache 2.0. 📂
В каждом из них используется одинаковая схема: детально прописанные роли с жесткими правилами поведения, пошаговые чеклисты под конкретные задачи и так называемые «taste tokens» (инструкции, которые определяют не суть задачи, а эстетику генерации).
Я объединил их в один проект, удалил дубликаты и написал простой CLI. 💻
📦 Что внутри
232 персоны агентов вместо шаблонного «act as a developer». Это узкие специалисты: 🧑💻
-
senior-fullstack: архитектурные решения, проведение code review по жестким стандартам 🏗️ -
sre-site-reliability-engineer: настройка SLO, планирование error budgets, хаос-инжиниринг 📉 -
solidity-smart-contract-engineer: EVM, оптимизация расхода газа, аудит безопасности DeFi 🔐 -
embedded-firmware-engineer: разработка bare-metal для ESP32, STM32, Nordic nRF 🔌 -
blockchain-security-auditor: поиск уязвимостей в смарт-контрактах, подготовка отчетов 🕵️
521 чеклист для выполнения конкретных задач: 📝
-
tdd-workflow: строгое следование циклу red → green → refactor 🔄 -
owasp-threat-modeling: моделирование угроз на этапе проектирования 🛡️ -
production-deployment: чек-лист проверки готовности перед релизом 🚀 -
stripe-integration-expert: обработка вебхуков, ключи идемпотентности, тесты 💳 -
liquid-glass-design: верстка эффекта glassmorphism с выверенными параметрами backdrop-filter 🎨
41 правило вкуса (папка rules/taste/). Они меняют не логику кода, а характер генерации: ✨
-
animate: использование spring physics вместо стандартных CSS-переходов 🏃♂️ -
bolder: контрастная иерархия шрифтов без блеклых серых тонов ✍️ -
overdrive: высокая визуальная плотность интерфейса для создания премиального вида 💎
⚡ Одна команда вместо копирования текста
git clone https://github.com/Arlandaren/proagents.git
cd proagents
# Посмотреть список доступных категорий
./proagents list
# Найти нужные файлы по ключевым словам
./proagents search react
# Установить правила в Cursor
./proagents install react-patterns --cursor
# Добавить инструкции в Claude Code
./proagents install senior-fullstack --stdout >> CLAUDE.md
# Посмотреть содержимое без установки
./proagents install ux-architect --info
Скрипт написан на чистом Python 3.8+ без внешних зависимостей. Запускается мгновенно. 🐍
Интегрируется с Cursor, Claude Code, Windsurf, Zed, Trae, Gemini CLI, OpenCode. 🔌
📊 Разница на практике
|
Параметр |
Базовый AI |
С библиотекой proagents |
|---|---|---|
|
UI 🎨 |
Серый Tailwind, стандартные шрифты |
HSL-палитры, микроанимации, glassmorphism |
|
Чистота кода 🧹 |
Захардкоженные значения |
Константы, типизированные ошибки, строгие типы |
|
Тестирование 🧪 |
«Напишем тесты позже» |
TDD с первой строчки кода |
|
Безопасность 🔒 |
OWASP игнорируется |
Моделирование угроз встроено в процесс |
|
Перформанс ⚡ |
Лишние ререндеры |
Целевые LCP-показатели, spring-анимации |
🛠️ Как это работает в реальной жизни
Представьте, что вы создаете React-компонент. С установленным правилом react-patterns редактор Cursor сразу знает: никаких эффектов без очистки ресурсов, мемоизация только при реальной необходимости, а состояние должно находиться на минимально достаточном уровне. 🧠
При написании смарт-контракта профиль solidity-smart-contract-engineer автоматически учитывает reentrancy, переполнение чисел, особенности прокси-контрактов и правила проверки перед отправкой в mainnet. ⛓️
Это не магия, а просто детально описанные требования к коду. 👍
🌐 Открытый проект под лицензией MIT
Репозиторий на GitHub: github.com/Arlandaren/proagents ⭐️
Если библиотека упростила вам жизнь, поддержите проект звездой на GitHub. Это помогает ему попадать в рекомендации. ⭐
Буду рад вашим лайкам на Хабре! 🙂
Если хотите добавить свои проверенные инструкции или персоны, присылайте PR. Достаточно добавить .md файл в соответствующую директорию. 🤝
Автор: alrn
