К основному содержанию
правило CX Codex

1-comments — правило для Claude Code и Cursor: комментарии без ссылок

Правило 1-comments для ИИ-агента: писать комментарий только там, где молчат код и имена, и не ссылаться на тикеты, PR и даты.

MIT ★ 571 обновлён 2026-10-29

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/1-comments.md
Открыть на GitHub

Что делает 1-comments

Правило срабатывает, когда агент пишет новый комментарий или решает, оставить ли старый. Пересказ следующей строки — повод удалить. История правки тоже. Остаётся то, чего не говорят код и имена: ограничение, которое не выразить типом, замеренная странность хоста, отвергнутая простая форма решения.

Внутри файла есть список paths — src/**/*.ts, tests/**/*.ts, scripts/**. За их пределами правило молчит. Комментарий занимает одну-две строки, длинное объяснение уходит в aidd_docs/memory/. В репозитории фреймворка tests/architecture/comments.arch.test.ts отбраковывает внешние ссылки и постепенно снижает допустимый объём.

Ссылку на тикет или PR правило запрещает прямо, так что привычный комментарий со ссылкой на задачу придётся переписать или выбросить. Без теста в своём проекте двухстрочный лимит держится на том, кто смотрит диф.

Какие задачи решает

  • убрать комментарии, которые пересказывают следующую строку
  • заменить ссылку на тикет описанием самого ограничения
  • сократить объяснение до двух строк и унести остальное в aidd_docs/memory/
  • записать замеренную странность хоста, которую не видно из типов
  • остановить рост объёма комментариев в проекте

Примеры запросов агенту

  • Пройди по src/**/*.ts и удали комментарии, которые повторяют код или рассказывают историю правки.
  • Оставь в этом файле только комментарии, где есть факт и его следствие, остальное убери.
  • Проверь диф на ссылки на тикеты, PR и URL внутри комментариев и перепиши их без ссылок.

Как установить 1-comments

Вручную: положить файлы

.claude/rules/1-comments.md

Поле paths во frontmatter ограничивает файлы

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

Вопросы о 1-comments

Как установить 1-comments в Claude Code?

Создай в проекте файл .claude/rules/1-comments.md и вставь в него текст правила.

Что делает 1-comments?

Задаёт агенту рамки для комментариев: оставлять факт и его следствие, не пересказывать код и не ссылаться на тикеты, PR, коммиты, даты, ревью и URL.

На какие файлы действует правило?

Список paths ограничивает его каталогами src/**/*.ts, tests/**/*.ts и scripts/**. В остальных файлах агент на него не опирается.

Исходный текст

1-comments.md · MIT
---
description: Apply when writing or keeping a comment; a comment says what the code cannot, and names no external reference.
paths:
  - "src/**/*.ts"
  - "tests/**/*.ts"
  - "scripts/**"
---

# Comments

- Comment only what code and names cannot say.
- Worth one: a constraint types miss, a measured host quirk, a refused simpler shape.
- Delete a comment that restates code or narrates history.
- Name no ticket, PR, commit, date, review or URL.
- Keep the fact and its consequence.
- One or two lines; a paragraph belongs in `aidd_docs/memory/`.
- `tests/architecture/comments.arch.test.ts` refuses external references and ratchets volume down.

© ai-driven-dev · MIT · ai-driven-dev/framework

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
add-educational-comments официальный github Скилл add-educational-comments для GitHub Copilot добавляет в код учебные комментарии, которые объясняют синтаксис и архитектурные решения. Запускается на любом файле из репозитория и превращает его в учебный материал без изменения логики. CX Codex +1 9 243установок code-comments petekp Скилл code-comments для Claude Code пишет, проверяет и удаляет комментарии в коде. Подключается при работе над комментариями или разборе изменений в diff. CX Codex +1 638установок lean-comments официальный github Скилл lean-comments для GitHub Copilot, который держит комментарии в коде минимальными и осмысленными. Включается при добавлении, правке, ревизии или чистке комментариев, docstrings, TODO, FIXME и других пометок в исходниках. CX Codex +1 17установок ponytail-debt DietrichGebert Скилл ponytail-debt собирает пометки shortcut: и старые ponytail: из репозитория в один список технического долга: файл, строка, потолок и условие пересмотра. CX Codex +1 59 300установок ds-unslop aicodeking Убирает шаблонные обороты из текста и комментариев к коду. Срабатывает при редактировании документации, ответов, описаний PR и коммитов или по команде /ds-unslop. CX Codex +1 547установок convention-learner codewithmukesh Скилл convention-learner для Claude Code анализирует существующий код и извлекает соглашения по именованию, структуре и стилю. Запускается перед генерацией кода, чтобы он соответствовал проекту. CX Codex +1 4 000установок

Из того же набора80

Весь набор →
0-folder-size Правило 0-folder-size следит, чтобы в каталоге было не больше десяти прямых .ts-файлов. Оно помогает заметить дублирование хелперов до дальнейшего разрастания структуры. CX Codex +1 ★ 571звёзд репо rule.generated Правило rule.generated требует добавлять комментарий «// Team reviewed domain change» над каждой новой экспортируемой функцией в папке src/domain/. Помогает отследить, какие изменения домена прошли ревью команды. CX Codex +1 ★ 571звёзд репо 1-type-honesty Правило 1-type-honesty запрещает опасные приведения типов вроде any в TypeScript-коде и убирает подавление ошибок компилятора. CX Codex +1 ★ 571звёзд репо 0-orchestration Правило 0-orchestration задаёт границы для оркестраторов в TypeScript: одна зависимость на каждую затронутую область и не больше четырёх других сценариев использования. CX Codex +1 ★ 571звёзд репо 01-ticket-info Скилл 01-ticket-info находит задачу в настроенном трекере и выводит её поля прямо в диалог с ассистентом. CX Codex +1 ★ 571звёзд репо 0-shared-modules Правило 0-shared-modules помогает решить, когда модуль действительно пора выносить в shared/. Оно пригодится при разборе структуры src/contexts/ и перемещении кода между областями приложения. CX Codex +1 ★ 571звёзд репо 01-hello Скилл 01-hello для Claude Code запускает действие greet и подтверждает, что плагин aidd-ui загружен. Он проверяет доступность плагина. CX Codex +1 ★ 571звёзд репо 7-auth Правило 7-auth задаёт правила чтения и сохранения токенов в коде: ленивый поиск GitHub-токена, жёсткие права на файлы и обработку ошибок авторизации. CX Codex +1 ★ 571звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой