🤖 Что происходит, когда вы просто пишете «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 файл в соответствующую директорию. 🤝