Project Coding Companion

Автор: Ruben Granet
Версия: 1.0.0
Лицензия: MIT

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

Работает с Claude Code, Claude.ai, Cursor и OpenAI Codex.

---

Что умеет

• Коучинг промптов — оценивает каждый запрос по 5 измерениям (контекст, намерение, область, ограничения, критерии приёмки) и задаёт точечные вопросы с пояснениями, если чего-то не хватает.
• Учитывает контекст диалога — распознаёт продолжения («ок, делай», «следующий шаг») и не переспрашивает то, на что вы уже ответили.
• Понимает репозитории — изучает структуру проекта, определяет стек и формирует модель кодовой базы.
• Планирует реализацию — предлагает короткие пошаговые планы (1–7 шагов) и ждёт вашего подтверждения.
• Реализует изменения — сначала читает, потом пишет, делает минимальные диффы, сохраняет существующий стиль.
• Ревьюит и резюмирует — перечисляет каждый изменённый файл, объясняет почему, предлагает тесты или дальнейшие шаги.
• Безопасен — никогда не делает автокоммит, не выполняет деструктивные команды без подтверждения.

Работает с любым языком и стеком: TypeScript, Python, Swift, Kotlin, Rust, Go, Java, Ruby, C# и другими.

---

Когда использовать

Хорошо подходит:

• У вас есть существующий репозиторий, и вы хотите добавить фичи, исправить баги, провести рефакторинг, написать тесты или разобраться в коде.
• Вы учитесь писать лучшие промпты для AI-ассистентов по кодингу.
• Вы хотите дисциплинированный рабочий процесс (оценка промпта → коучинг → план → реализация → ревью) вместо хаотичной генерации кода.

Не лучший выбор:

• Чистый гринфилд-скаффолдинг без существующего кода.
• Задачи не связанные с кодом (документы, презентации, таблицы).
• Тяжёлая фронтенд-дизайн работа, основанная преимущественно на эстетике.

---

Поддерживаемые платформы

Репозиторий содержит три файла — одинаковые инструкции, адаптированные под каждую платформу:

Платформа	Файл	Как работает
Claude Code	project-coding-companion/SKILL.md	Устанавливается как Claude Skill — срабатывает автоматически на запросы по кодингу
Claude.ai	project-coding-companion/SKILL.md	Загружается через Settings → Capabilities → Skills
Cursor	.cursorrules	Размещается в корне проекта — применяется ко всем диалогам Cursor в этом проекте
OpenAI Codex	AGENTS.md	Размещается в корне проекта — Codex читает его как инструкции агента

---

Структура папок

project-coding-companion-skill/ ← Этот репозиторий ├── README.md ← Вы здесь (для людей на GitHub) ├── LICENSE ← MIT ├── project-coding-companion/ ← Папка Claude Skill │ └── SKILL.md ← Claude Code & Claude.ai ├── .cursorrules ← Cursor └── AGENTS.md ← OpenAI Codex

Примечание: README.md находится в корне репозитория для читателей GitHub. Он не входит в папку скилла — согласно спецификации Anthropic, папка скилла содержит только SKILL.md и опциональные директории scripts/, references/, assets/.

---

Установка

Быстрая установка

npx skills add rgranet/project-coding-companion-skill

Claude Code

1. Клонируйте репозиторий: git clone https://github.com/rgranet/project-coding-companion-skill.git
2. Поместите папку project-coding-companion/ в директорию скиллов Claude Code.
3. Скилл активируется автоматически на запросы по кодингу.

Claude.ai (веб и десктоп)

1. Заархивируйте папку скилла (не весь репозиторий): zip -r project-coding-companion.zip project-coding-companion/
2. Перейдите в Settings → Capabilities → Skills.
3. Нажмите Upload skill и выберите zip-файл.

Cursor

1. Скопируйте .cursorrules из этого репозитория в корень вашего проекта: cp .cursorrules /path/to/your/project/
2. Откройте проект в Cursor — правила применяются автоматически ко всем диалогам.

Важно: .cursorrules должен находиться в корне проекта, над которым вы работаете, а не в отдельной папке скиллов. Каждый проект получает свою копию.

OpenAI Codex

1. Скопируйте AGENTS.md из этого репозитория в корень вашего проекта: cp AGENTS.md /path/to/your/project/
2. Codex читает AGENTS.md автоматически как инструкции агента.

Важно: Как и .cursorrules, файл AGENTS.md должен находиться в корне проекта, над которым вы работаете.

---

Примеры рабочих процессов

1. Расплывчатый запрос → коучинг → реализация

Вы: «Добавь поиск в моё приложение»

1. Обнаруживает 3+ отсутствующих измерения, переходит в режим коучинга.
2. Задаёт 3 точечных вопроса (какой экран? что ищем? в реальном времени или по отправке?) с пояснениями «→ Почему это важно».
3. Вы отвечаете. Переформулирует задачу в виде чеклиста для подтверждения.
4. Изучает кодовую базу, планирует шаги, реализует, резюмирует изменения.
5. Завершает советом по промптингу: «В следующий раз упоминание целевого экрана сэкономит один раунд вопросов».

2. Чёткий запрос → сразу к коду

Вы: «Добавь свойство isFavorite: Bool к сущности Thought, кнопку переключения в ThoughtDetailView и FavoritesListView с фильтром по isFavorite == true. Следуй существующему паттерну MVVM.»

1. Оценивает: все 5 измерений присутствуют. «Чётко и полно — у меня есть всё необходимое».
2. Планирует 4 шага, реализует с минимальными диффами, резюмирует.

3. Явный коучинг промптов

Вы: «Хочу отрефакторить слой сервисов, но не знаю, как это описать. Помоги написать хороший промпт.»

1. Просит описать болевые точки своими словами.
2. Показывает скоркард по 5 измерениям (✅/❌/⚠️).
3. Предлагает переработанный промпт со всеми заполненными измерениями.
4. Объясняет ключевые улучшения, чтобы вы могли применять тот же подход в будущем.