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

file-headers — правило для Claude Code: шапка в каждом файле

Правило file-headers требует, чтобы каждый исходник начинался с комментария-шапки: короткое описание файла и строка @author Son Nguyen <[email protected]>.

MIT ★ 1 198 обновлён 2026-10-23

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

Что делает file-headers

Правило задаёт шапку для файлов .js, .ts, .tsx, .cjs, .mjs, .py, .sh и .css. В начале файла — честное описание того, что в нём происходит, и точная строка @author Son Nguyen <[email protected]>. Вне правила остаются node_modules/, dist/, data/, .worktrees/, минифицированный и вендорный код, сгенерированный wiki/i18n-content.js и снапшоты.

Это обязательство для агента, а не для человека. Создаёшь файл — шапка пишется до кода, в скриптах после shebang. При правке файла без шапки она добавляется тем же изменением. Если правка меняет назначение файла, описание переписывается заодно.

Проверка автоматическая: bash .claude/skills/file-headers/scripts/check-headers.sh должен завершиться с кодом 0. Скрипт и форматы шапок лежат в .claude/skills/file-headers/, поэтому без этого скилла в проекте правило держится на честном слове. Установка — один файл .claude/rules/file-headers.md.

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

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

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

  • Создай src/metrics.ts и сразу поставь сверху шапку с @author Son Nguyen <[email protected]>.
  • В scripts/deploy.sh нет шапки — добавь её после shebang, логику не трогай.
  • Прогони bash .claude/skills/file-headers/scripts/check-headers.sh и почини все файлы, на которые он ругается.

Как установить file-headers

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

.claude/rules/file-headers.md

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

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

Вопросы о file-headers

Как установить file-headers в Claude Code?

Положить файл правила по пути .claude/rules/file-headers.md. Claude читает правила из этой папки.

Что делает file-headers?

Заставляет каждый подходящий исходник начинаться с краткого описания и точной строки @author Son Nguyen <[email protected]>. Шапка добавляется и при правке файла, где её не было.

Чем проверить, что весь репозиторий соответствует правилу?

Запустить bash .claude/skills/file-headers/scripts/check-headers.sh: он должен выйти с кодом 0. Сам скрипт и форматы шапок хранятся в .claude/skills/file-headers/.

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

file-headers.md · MIT
# File Header Rules (binding for every coding agent)

- Every applicable source file (`.js/.ts/.tsx/.cjs/.mjs/.py/.sh/.css` — excluding `node_modules/`, `dist/`, `data/`, `.worktrees/`, minified/vendored, generated `wiki/i18n-content.js`, snapshots) MUST start with the header comment: a truthful file overview plus the exact line `@author Son Nguyen <[email protected]>`.
- Creating a new applicable file → write the header before any code (after the shebang in scripts).
- Editing a file that lacks the header → add it in the same change; if the edit changes the file's purpose, update the overview.
- Formats and the repo-wide audit script live in `.claude/skills/file-headers/` (`bash .claude/skills/file-headers/scripts/check-headers.sh` must exit 0).

© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor

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

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
self-explanatory-code-commenting официальный github Правило self-explanatory-code-commenting для GitHub Copilot запрещает очевидные комментарии и оставляет пояснения для неочевидных решений, бизнес-логики и ограничений API. CX Codex +1 ★ 41 430звёзд репо code-style frappe Скилл code-style для Claude Code задаёт правила оформления кода. Он подключается при написании и правке кода, а также по вопросам рефакторинга и комментариев. CX Codex +1 1 100установок write-coding-standards-from-file официальный github Скилл write-coding-standards-from-file для GitHub Copilot анализирует файлы проекта и формирует документ со стандартами кода. Выводит правила из существующих примеров. CX Codex +1 9 570установок code-style-consistency-cursorrules-prompt-file PatrickJS Правило code-style-consistency-cursorrules-prompt-file для Cursor заставляет агента изучить стиль проекта перед написанием кода. Работает с репозиториями, где уже закреплены свои конвенции. CX Codex +1 ★ 41 178звёзд репо software-engineer siviter-xyz Скилл software-engineer задаёт агенту правила стиля кода, документации и рабочего процесса: без лишних комментариев, без самовольных git-коммитов, с вопросами при неясностях. CX Codex +1 637установок wiki-agents-md Microsoft Скилл wiki-agents-md сканирует папки репозитория и генерирует файлы AGENTS.md с командами сборки, тестами и стилем кода. Существующие инструкции он принципиально не перезаписывает. CX Codex +1 5установок

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

Весь набор →
report Команда report для Claude Code формирует отчёты CCAM по затратам, надёжности, рабочим процессам или для руководства. Тип отчёта и область данных задаются в запросе. CX Codex +1 ★ 1 198звёзд репо release-guard Скилл release-guard прогоняет проверки готовности к релизу: сверяет команды в документации с package.json, смотрит, не разошлось ли описание архитектуры с кодом. CX Codex +1 ★ 1 198звёзд репо repo-onboarding Скилл repo-onboarding помогает агенту быстро разобраться в структуре репозитория, определить нужный слой и подготовить команды проверки перед правками. CX Codex +1 ★ 1 198звёзд репо mcp-maintainer Скилл mcp-maintainer помогает обслуживать локальный MCP-сервер: проверять его состояние, менять инструменты и разбираться с проблемами запуска. Пригодится при работе с MCP в этом репозитории. CX Codex +1 ★ 1 198звёзд репо status Команда status опрашивает локальный дашборд Claude Code Agent Monitor и выводит статус и метрики сессий одной строкой. CX Codex +1 ★ 1 198звёзд репо open-dashboard Open-dashboard показывает адрес Agent Monitor и команды для запуска панели или открытия адреса. CX Codex +1 ★ 1 198звёзд репо report-analyst Субагент report-analyst для Claude Code собирает из локального CCAM API отчёты по стоимости, надёжности и рабочим процессам в Markdown. Формирует выжимку для руководства с проверяемыми числами. CX Codex ★ 1 198звёзд репо ping Команда ping проверяет доступность локального дашборда Agent Monitor через API и выводит статус UP или DOWN с временем отклика. CX Codex +1 ★ 1 198звёзд репо

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

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