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

1-conventions — правило для Claude Code: что делает и как установить

Правило 1-conventions задаёт соглашения для TypeScript-файлов в src/ и tests/: структуру модулей, имена файлов и уровни тестов. Оно пригодится при добавлении кода и тестов в проект.

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

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

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

Правило применяется к src/**/*.ts и tests/**/*.ts. Оно требует именованные экспорты, запрещает barrel-файлы и реэкспорты, задаёт относительные импорты с расширением .js и предписывает использовать import type для типов. Для файлов нужны имена в kebab-case.ts, а типы тестов различаются по суффиксам .unit.test.ts, .integration.test.ts и .e2e.test.ts.

Для архитектурных тестов есть отдельное условие: файл *.arch.test.ts должен лежать в tests/architecture/, иначе он не запускается. Каталог tests/ должен повторять структуру src/. Дублирование проверяет pnpm jscpd; общий код предлагают выносить при появлении второго вызывающего места. Суффиксы файлов важны: проверки по ним не заметят файл с неправильным именем.

В Claude Code правило устанавливается файлом .claude/rules/1-conventions.md. Для Cursor и GitHub Copilot указаны отдельные пути. Правило охватывает TypeScript-файлы, поэтому соглашения из него не относятся к файлам с другими расширениями.

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

  • задать единый стиль экспортов и импортов в TypeScript-модулях
  • назвать файлы и символы по соглашениям проекта
  • разделить unit-, integration- и e2e-тесты по именам файлов
  • найти дублирующийся код через pnpm jscpd
  • проверить расположение архитектурных тестов

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

  • Добавь модуль в src/ и соблюдай правила экспортов и импортов.
  • Создай unit-тест для этого модуля с правильным суффиксом файла.
  • Проверь, почему этот архитектурный тест не запускается.

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

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

.claude/rules/1-conventions.md

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

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

Вопросы о 1-conventions

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

Добавь в проект файл .claude/rules/1-conventions.md с содержимым правила.

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

Правило задаёт соглашения для TypeScript-файлов в src/ и tests/: экспорты, импорты, имена и расположение тестов.

Почему архитектурный тест может не запускаться?

Файл *.arch.test.ts вне tests/architecture/ не запускается. Проверь его расположение.

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

1-conventions.md · MIT
---
description: Apply to every source and test file; module shape, naming and test tiers.
paths:
  - "src/**/*.ts"
  - "tests/**/*.ts"
---

# Conventions

## Modules

- Named exports only; biome's `noDefaultExport` holds it under `src/` and `tests/`.
- No barrel, no re-export: biome's `noBarrelFile`, `noReExportAll`, `noExportedImports`, plus `no-re-export.arch.test.ts` for `export { x } from` (`tests/helpers/ports/` exempt).
- Import from the defining module, relative, `.js` extension.
- `import type` for a type-only import.

## Names

- `kebab-case.ts` files; suffixes `-adapter.ts`, `-use-case.ts`.
- A port file is named for its interface: `file-merger.ts` for `FileMerger`.
- The ratchets read those suffixes; a misnamed file is invisible.
- `camelCase` values, `PascalCase` types, `CONSTANT_CASE` module constants.
- A leading underscore marks a parameter an interface forces.
- Name the intention: `applyFrameworkFile`, not `writeThenHash`.
- `executeInternal` means no concept was found; do not make it.

## Tests

- The extension declares the tier: `*.unit.test.ts`, `*.integration.test.ts`, `*.e2e.test.ts`.
- An `*.arch.test.ts` outside `tests/architecture/` runs nowhere.
- `tests/` mirrors `src/`.

## Duplication

- `pnpm jscpd` fails a copied block.
- Extract at the second caller (`0-shared-modules.md`).

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

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

Все правила IDE по теме «Тесты и QA» →
engineering-conventions ZaxbyHub Скилл engineering-conventions задаёт обязательные инженерные инварианты для доработки opencode-swarm. Помогает избежать зависаний инициализации, утечек тестовых моков и поломок совместимости с Node ESM. CX Codex +1 ★ 539звёзд репо mcp-server-analyzer Anselmoo MCP-сервер mcp-server-analyzer проверяет Python, JavaScript и TypeScript с Ruff, ty, Vulture и Biome. Подходит для ревью, форматирования и поиска мёртвого кода. CX Codex +1 ★ 11звёзд репо caliber-conventions caliber-ai-org Правило caliber-conventions задаёт соглашения для разработки CLI-проектов Caliber на TypeScript. Оно пригодится, чтобы агент учитывал требования проекта при работе с кодом и тестами. CX Codex +1 ★ 1 319звёзд репо ultracite haydenbleasel Скилл ultracite настраивает линтинг и форматирование JS/TS-проектов через Oxlint, Biome или ESLint одной командой. CX Codex +1 13 600установок typescript-quality claude-dev-suite Скилл typescript-quality для Claude Code: настраивает ESLint, Biome и строгий tsconfig для TypeScript и JavaScript. Включается, когда в проекте расходятся типы и множатся правила линтера. CX Codex +1 1 100установок bencium-code-conventions bencium Скилл bencium-code-conventions задаёт правила Bence для React и Next.js: стек, стиль кода, тесты и рабочий процесс. Нужен при создании или настройке проекта по этим соглашениям. CX Codex +1 3 500установок

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

Весь набор →
06-agent-generate Скилл 06-agent-generate генерирует конфигурации агентов и субагентов под форматы поддерживаемых ИИ-инструментов проекта по описанию роли. CX Codex +1 ★ 571звёзд репо 02-challenge Скилл 02-challenge сверяет готовую работу с согласованным планом и выдаёт структурированный отчёт. Пригодится, чтобы решить, выпускать результат, дорабатывать или переделывать. CX Codex +1 ★ 571звёзд репо 05-spike Скилл 05-spike ведёт спайк — короткое расследование одного вопроса, который мешает оценить задачу, проверить осуществимость или выбрать решение. CX Codex +1 ★ 571звёзд репо 0-contexts Правило 0-contexts ограничивает импорты между контекстами TypeScript-проекта и защищает ядро от бизнес-логики. CX Codex +1 ★ 571звёзд репо 05-rule-generate Скилл 05-rule-generate проводит правило кодинга от черновика до записи в файлы установленных ИИ-хостов: создание, правка, публикация, удаление. CX Codex +1 ★ 571звёзд репо 07-command-generate Скилл 07-command-generate для Claude Code создаёт и обновляет плоские слэш-команды для подключённых в проекте ИИ-инструментов. Готовит команды вызова без ручной подгонки путей. CX Codex +1 ★ 571звёзд репо 0-hexagonal Правило 0-hexagonal раскладывает код контекста по четырём слоям и направляет зависимости внутрь. Оно пригодится для проверки архитектуры TypeScript-кода. CX Codex +1 ★ 571звёзд репо 09-mermaid Скилл 09-mermaid для Claude Code собирает диаграммы Mermaid из текста: сначала планирует, затем генерирует и проверяет их. Показывает архитектуру или поток схемой, а не абзацем. CX Codex +1 ★ 571звёзд репо

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

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