@bonesofspring/ai-rules 0.2.0 → 0.2.2

package/presets/claude/next/hooks/chain-team-phases.sh

@@ -1,342 +0,0 @@
-#!/usr/bin/env bash
-# Chains agent team phases after subagent completion when wired into Claude Code hooks.
-
-set -euo pipefail
-
-input=$(cat)
-
-INPUT="$input" node <<'NODE'
-const fs = require('fs');
-const path = require('path');
-
-const TEAM_ROOT = path.join(process.cwd(), '.claude', 'team');
-
-const inputRaw = process.env.INPUT || '';
-let hookInput;
-try {
-  hookInput = JSON.parse(inputRaw);
-} catch {
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-if (hookInput.status !== 'completed') {
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-const activePath = path.join(TEAM_ROOT, 'active-task.json');
-
-if (!fs.existsSync(activePath)) {
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-let active;
-try {
-  active = JSON.parse(fs.readFileSync(activePath, 'utf8'));
-} catch {
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-const slug = active.slug;
-if (!slug) {
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-const taskDir = path.join(TEAM_ROOT, 'tasks', slug);
-const statusPath = path.join(taskDir, 'status.json');
-const pipelinePath = path.join(taskDir, 'pipeline.json');
-
-if (!fs.existsSync(statusPath)) {
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-let status;
-try {
-  status = JSON.parse(fs.readFileSync(statusPath, 'utf8'));
-} catch {
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-const now = new Date().toISOString();
-
-function writeStatus(next) {
-  status = { ...status, ...next, slug, updatedAt: now };
-  fs.writeFileSync(statusPath, JSON.stringify(status, null, 2) + '\n');
-}
-
-function out(message) {
-  process.stdout.write(JSON.stringify({ followup_message: message }));
-}
-
-function readArtifact(name) {
-  const p = path.join(taskDir, name);
-  if (!fs.existsSync(p)) return '';
-  try {
-    return fs.readFileSync(p, 'utf8');
-  } catch {
-    return '';
-  }
-}
-
-function getStepAgents(step) {
-  if (!step) return [];
-  return Array.isArray(step.agent) ? step.agent : [step.agent];
-}
-
-function skipIfMatches(skipIf) {
-  if (!skipIf) return false;
-  if (skipIf === 'debugger.fixed') {
-    const text = readArtifact('debug-report.md');
-    return /fixApplied:\s*true/i.test(text) || /\*\*Fix applied:\*\*\s*true/i.test(text);
-  }
-  if (skipIf === 'ci-investigator.resolved') {
-    const text = readArtifact('ci-report.md');
-    return /fixApplied:\s*true/i.test(text) || /## Verdict\s*\nPASS/i.test(text);
-  }
-  return false;
-}
-
-function findNextExecutableStep(steps, startIdx) {
-  for (let i = startIdx; i < steps.length; i++) {
-    if (!skipIfMatches(steps[i].skipIf)) {
-      return { step: steps[i], index: i };
-    }
-  }
-  return null;
-}
-
-const AGENT_HANDOFF = {
-  'task-analyst': (s) =>
-    `Invoke task-analyst for slug "${s}". Write brief.md and decomposition.md under .claude/team/tasks/${s}/. ` +
-    `Set status.json: phase executing, state awaiting_approval if human gate applies.`,
-  debugger: (s) =>
-    `Invoke debugger subagent for slug "${s}". Write debug-report.md with fixApplied: true/false. Update status.json when done.`,
-  'solution-architect': (s) =>
-    `Invoke solution-architect for slug "${s}". Read brief.md; write architecture.md. Update status.json when done.`,
-  'migration-specialist': (s) =>
-    `Invoke migration-specialist for slug "${s}". Read brief.md; write migration-plan.md. Update status.json when done.`,
-  'api-contract-reviewer': (s) =>
-    `Invoke api-contract-reviewer for slug "${s}". Write api-contract-review.md. Update status.json when done.`,
-  'ci-investigator': (s) =>
-    `Invoke ci-investigator for slug "${s}". Use ci-investigation skill. Write ci-report.md. Update status.json when done.`,
-  'feature-developer': (s) =>
-    `Invoke feature-developer for slug "${s}". Read brief.md, decomposition.md, validation-report.md, review.md if present. ` +
-    `Follow rules/architecture/feature-delivery-workflow.md and architecture/reference-features.md. Include unit tests before handoff. Update status.json when done.`,
-  'build-verifier': (s) =>
-    `Invoke build-verifier for slug "${s}". Run lint:js, lint:css, type-check, targeted unit tests from app/. ` +
-    `Write validation-report.md. Set state completed or validation_failed. Do not edit production code.`,
-  'accessibility-reviewer': (s) =>
-    `Invoke accessibility-reviewer for slug "${s}". Write a11y-review.md. Update status.json when done.`,
-  'performance-auditor': (s) =>
-    `Invoke performance-auditor for slug "${s}". Write perf-report.md. Update status.json when done.`,
-  'code-reviewer': (s) =>
-    `Invoke code-reviewer for slug "${s}". Review git diff per rules/tooling-and-review/code-review-mr.md. Update status.json when done.`,
-  'security-reviewer': (s) =>
-    `Invoke security-reviewer for slug "${s}". Write security-review.md. Update status.json when done.`,
-  'qa-tester': (s, scope) =>
-    `Invoke qa-tester for slug "${s}"${scope ? ` (scope: ${scope})` : ''}. Update status.json when done.`,
-  'unit-test-planner': (s) =>
-    `Invoke unit-test-planner for slug "${s}". Use unit-testing skill. Update status.json when done.`,
-  'unit-test-generator': (s) =>
-    `Invoke unit-test-generator for slug "${s}". Use unit-testing skill. Update status.json when done.`,
-  'unit-test-healer': (s) =>
-    `Invoke unit-test-healer for slug "${s}". Use unit-testing and debug-investigation skills. Update status.json when done.`,
-  'playwright-test-planner': (s) =>
-    `Invoke playwright-test-planner for slug "${s}". Follow rules/testing/playwright-agents.md and playwright-e2e skill. Update status.json when done.`,
-  'playwright-test-generator': (s) =>
-    `Invoke playwright-test-generator for slug "${s}". Use Playwright MCP tools when available. Update status.json when done.`,
-  'playwright-test-healer': (s) =>
-    `Invoke playwright-test-healer for slug "${s}". Use Playwright MCP when available. Update status.json when done.`,
-  'tech-writer': (s) =>
-    `Invoke tech-writer for slug "${s}". Write documentation.md. Update status.json when done.`,
-};
-
-const REVIEW_AGENTS = new Set([
-  'code-reviewer',
-  'accessibility-reviewer',
-  'security-reviewer',
-  'api-contract-reviewer',
-]);
-
-function handoffForAgent(agent, scope) {
-  const fn = AGENT_HANDOFF[agent];
-  return fn ? fn(slug, scope) : `Invoke ${agent} subagent for slug "${slug}". Update status.json when done.`;
-}
-
-function handoffForParallelStep(step) {
-  const agents = getStepAgents(step);
-  return (
-    `Invoke IN PARALLEL (one message, multiple Task calls): ${agents.join(' AND ')} for slug "${slug}". ` +
-    `Each agent appends itself to status.json parallelCompleted when done.`
-  );
-}
-
-function hasGateAfter(agent, humanGates) {
-  return Array.isArray(humanGates) && humanGates.includes(`after:${agent}`);
-}
-
-function hasGateAfterStep(step, humanGates) {
-  return getStepAgents(step).some((a) => hasGateAfter(a, humanGates));
-}
-
-function legacyFlow() {
-  if (status.phase === 'development' && status.state === 'completed') {
-    writeStatus({ phase: 'executing', state: 'in_progress', currentAgent: 'build-verifier' });
-    out(handoffForAgent('build-verifier'));
-    process.exit(0);
-  }
-  if (status.currentAgent === 'build-verifier' && status.state === 'completed') {
-    writeStatus({ phase: 'executing', state: 'in_progress', currentAgent: 'code-reviewer' });
-    out(handoffForAgent('code-reviewer'));
-    process.exit(0);
-  }
-  if (status.phase === 'review' && status.state === 'completed') {
-    writeStatus({ phase: 'executing', state: 'in_progress', currentAgent: 'qa-tester' });
-    out(handoffForAgent('qa-tester'));
-    process.exit(0);
-  }
-  if (status.state === 'changes_requested' && REVIEW_AGENTS.has(status.currentAgent)) {
-    writeStatus({
-      currentAgent: 'feature-developer',
-      state: 'in_progress',
-      phase: 'executing',
-      retryAfterFix: status.currentAgent,
-    });
-    out(handoffForAgent('feature-developer') + ` After fixes, re-run ${status.currentAgent}.`);
-    process.exit(0);
-  }
-  if (status.state === 'validation_failed') {
-    writeStatus({
-      currentAgent: 'feature-developer',
-      state: 'in_progress',
-      retryAfterFix: 'build-verifier',
-    });
-    out(handoffForAgent('feature-developer') + ` Read validation-report.md. Re-run build-verifier after fixes.`);
-    process.exit(0);
-  }
-  if (status.state === 'completed' && status.retryAfterFix) {
-    const retry = status.retryAfterFix;
-    writeStatus({ currentAgent: retry, state: 'in_progress', retryAfterFix: null });
-    out(handoffForAgent(retry));
-    process.exit(0);
-  }
-  if (status.phase === 'testing' && status.state === 'completed') {
-    writeStatus({ phase: 'done', state: 'completed' });
-    out(`Pipeline complete for "${slug}". Run /technical-retro ${slug}.`);
-    process.exit(0);
-  }
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-if (!fs.existsSync(pipelinePath)) {
-  legacyFlow();
-}
-
-let pipeline;
-try {
-  pipeline = JSON.parse(fs.readFileSync(pipelinePath, 'utf8'));
-} catch {
-  legacyFlow();
-}
-
-const steps = pipeline.steps || [];
-if (steps.length === 0 || pipeline.autoChain === false) {
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-if (status.awaitingHumanGate || status.state === 'awaiting_approval') {
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-if (status.state === 'changes_requested' && REVIEW_AGENTS.has(status.currentAgent)) {
-  const reviewer = status.currentAgent;
-  writeStatus({
-    currentAgent: 'feature-developer',
-    state: 'in_progress',
-    phase: 'executing',
-    retryAfterFix: reviewer,
-  });
-  out(handoffForAgent('feature-developer') + ` After fixes, re-run ${reviewer}.`);
-  process.exit(0);
-}
-
-if (status.state === 'validation_failed' && status.currentAgent === 'build-verifier') {
-  writeStatus({
-    currentAgent: 'feature-developer',
-    state: 'in_progress',
-    phase: 'executing',
-    retryAfterFix: 'build-verifier',
-  });
-  out(handoffForAgent('feature-developer') + ` Read validation-report.md. Re-run build-verifier after fixes.`);
-  process.exit(0);
-}
-
-if (status.state === 'completed' && status.retryAfterFix) {
-  const retry = status.retryAfterFix;
-  writeStatus({ currentAgent: retry, state: 'in_progress', retryAfterFix: null });
-  out(handoffForAgent(retry));
-  process.exit(0);
-}
-
-const idx = typeof status.pipelineIndex === 'number' ? status.pipelineIndex : 0;
-const currentStep = steps[idx];
-if (!currentStep) {
-  writeStatus({ phase: 'done', state: 'completed', currentAgent: null });
-  out(`Pipeline complete for "${slug}". Run /technical-retro ${slug}.`);
-  process.exit(0);
-}
-
-const completedAgent = status.currentAgent || getStepAgents(currentStep)[0];
-const stepAgents = getStepAgents(currentStep);
-
-if (currentStep.parallel && stepAgents.length > 1) {
-  const done = [...(status.parallelCompleted || [])];
-  if (completedAgent && !done.includes(completedAgent)) done.push(completedAgent);
-  writeStatus({ parallelCompleted: done });
-  if (stepAgents.filter((a) => !done.includes(a)).length > 0) {
-    process.stdout.write('{}');
-    process.exit(0);
-  }
-  writeStatus({ parallelCompleted: [] });
-}
-
-if (hasGateAfterStep(currentStep, pipeline.humanGates)) {
-  writeStatus({ awaitingHumanGate: true, state: 'awaiting_approval', currentAgent: completedAgent });
-  process.stdout.write('{}');
-  process.exit(0);
-}
-
-const next = findNextExecutableStep(steps, idx + 1);
-if (!next) {
-  writeStatus({ pipelineIndex: steps.length, phase: 'done', state: 'completed', currentAgent: null });
-  out(`Pipeline complete for "${slug}". Run /technical-retro ${slug}.`);
-  process.exit(0);
-}
-
-const { step: nextStep, index: nextIdx } = next;
-const nextAgents = getStepAgents(nextStep);
-
-writeStatus({
-  pipelineIndex: nextIdx,
-  currentAgent: nextAgents[0],
-  phase: 'executing',
-  state: 'in_progress',
-  awaitingHumanGate: false,
-  parallelCompleted: [],
-});
-
-if (nextStep.parallel && nextAgents.length > 1) {
-  out(handoffForParallelStep(nextStep));
-} else {
-  out(handoffForAgent(nextAgents[0], nextStep.scope));
-}
-NODE

package/presets/claude/next/hooks/guard-shell-command.sh

@@ -1,77 +0,0 @@
-#!/usr/bin/env bash
-# Lightweight shell guard for Claude projects using this preset.
-
-set -euo pipefail
-
-input=$(cat)
-
-INPUT="$input" node <<'NODE'
-const fs = require('fs');
-
-const raw = process.env.INPUT || '';
-let event;
-try {
-  event = JSON.parse(raw);
-} catch {
-  process.stdout.write('{ "permission": "allow" }');
-  process.exit(0);
-}
-
-const command = String(event.command || event.input?.command || '');
-if (!command.trim()) {
-  process.stdout.write('{ "permission": "allow" }');
-  process.exit(0);
-}
-
-function out(permission, userMessage, agentMessage) {
-  process.stdout.write(JSON.stringify({
-    permission,
-    user_message: userMessage,
-    agent_message: agentMessage || userMessage,
-  }));
-}
-
-const dangerousGit = /\bgit\s+(reset\s+--hard|clean\s+-[^\n]*f|push\s+--force|push\s+-f|checkout\s+--\s+)/;
-if (dangerousGit.test(command)) {
-  out(
-    'ask',
-    'This command looks destructive for git state. Review it before continuing.',
-    'A project hook flagged a destructive git command. Ask the user before running it.',
-  );
-  process.exit(0);
-}
-
-const managerByFile = [
-  ['yarn.lock', 'yarn'],
-  ['pnpm-lock.yaml', 'pnpm'],
-  ['package-lock.json', 'npm'],
-].find(([file]) => fs.existsSync(file));
-
-let expected = managerByFile?.[1];
-if (!expected && fs.existsSync('package.json')) {
-  try {
-    const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
-    const pm = typeof pkg.packageManager === 'string' ? pkg.packageManager : '';
-    expected = pm.split('@')[0] || undefined;
-  } catch {
-    // Ignore invalid package.json in the hook; the agent can diagnose it later.
-  }
-}
-
-if (!expected) {
-  process.stdout.write('{ "permission": "allow" }');
-  process.exit(0);
-}
-
-const used = command.match(/(^|[;&|]\s*)(npm|yarn|pnpm)\s+/)?.[2];
-if (used && used !== expected) {
-  out(
-    'ask',
-    `This repository appears to use ${expected}, but the command uses ${used}. Confirm before continuing.`,
-    `Use ${expected} for package scripts and installs unless the user explicitly approves ${used}.`,
-  );
-  process.exit(0);
-}
-
-process.stdout.write('{ "permission": "allow" }');
-NODE

package/presets/claude/next/rules/api-and-data/api-services.md

@@ -1,57 +0,0 @@
----
-paths:
-  - app/src/api/services/**/*.ts
----
-
-# Роль API слоя
-
-- Инкапсулировать всё, что связано с:
-  - HTTP‑запросами через **экземпляры прикладных API‑клиентов** в `app/src/api/clients/**`, собранные на **общей реализации** из `app/src/lib/clients/**` (как в существующем коде); подробности — **`api-and-data/http-client.md`**; положение слоя в схеме **порты и адаптеры** — `architecture/architecture-boundaries.md`;
-  - URL/путями,
-  - заголовками и кодами ответов,
-  - DTO backend.
-- Предоставлять UI и store **стабильный доменный интерфейс**:
-  - функции, работающие с доменными типами из `@/types` (`architecture/public-imports.md`).
-  - мапперы между DTO и доменными типами.
-
-# Структура модулей
-
-- Для каждой доменной области (например, заказы, биллинг, настройки аккаунта):
-  - отдельный каталог в `app/src/api/services/<ИмяСервиса или фичи>/**` по конвенции репозитория.
-- Внутри модуля:
-  - файлы с вызовами API (`index.ts` или `*.service.ts`);
-  - файлы мапперов (`*responseMappers.ts`);
-  - специфичные типы запросов/ответов (если не вынесены в `app/src/types/**` с экспортом через barrel `@/types`).
-  - при необходимости — локальные `index.ts` / barrel внутри модуля для структуры **внутри** `app/src/api/**`; **снаружи** этого слоя UI, store и остальной код импортируют только из корневого barrel `app/src/api/index.ts` (`import … from '@/api'`, **`architecture/public-imports.md`**).
-
-# Мапперы и типы
-
-- Для каждого запроса/эндпоинта:
-  - описывать **response‑тип (DTO)**, точно соответствующий контракту backend;
-  - определять **целевой доменный тип** в `app/src/types/**`, с которым будет работать приложение (включая вычисляемые/агрегированные поля).
-- Мапперы (например, `*responseMappers.ts`):
-  - чистые функции, без сайд‑эффектов;
-  - выполняют все необходимые вычисления и преобразования данных (булевы флаги, склейка строк, агрегаты и т.п.) при переводе из DTO в доменные модели;
-  - при необходимости обеспечивают обратное преобразование (доменные модели → транспортные типы).
-- UI и store работают только с доменными типами (из `@/types` или экспортируемыми из public API слоя API), а не с «сырыми» DTO.
-- **Не вызывать `fetch` напрямую** в теле API‑методов: только через клиент; исключения — узкие модули (например JSON‑RPC), если так уже устроено в репозитории.
-
-# Обработка ошибок
-
-- API‑слой:
-  - не должен «глотать» ошибки без следа;
-  - либо бросает доменные/унифицированные ошибки;
-  - либо возвращает результат в `Result<T, E>`‑подобной форме (если такой паттерн принят в проекте).
-- Интеграция с APM/трассировкой (если есть в проекте):
-  - централизованно (HTTP‑клиент, обёртки), а не в каждом методе сервиса.
-
-# Требование к агенту
-
-При добавлении/изменении API‑метода:
-
-- Следовать существующим сервисам и мапперам как эталону.
-- Пройти чеклист barrel-экспортов (**`architecture/layer-barrel-exports.md`**): локальный `index.ts` → фасад слоя → корневой barrel.
-- Не смешивать слой API и UI/store:
-  - компоненты не должны зависеть от DTO;
-  - store не должен сам собирать URL/коды эндпоинтов и не обходить сервисы; **транспортный тип ответа** и **контракт ошибки** из `@/types` (как у прикладного клиента) допустимы во thunk при разборе `catch`/payload, если так выстроен сервис (см. `api-and-data/store-rtk.md`, `api-and-data/http-client.md`).
-- При использовании API‑сервисов в UI, store и утилитах **вне** `app/src/api/**` импортировать **только** из `@/api` (корневой barrel), см. **`architecture/public-imports.md`**; внутри слоя API — по относительным путям или `@/api/services/**` / `@/api/clients/**`, не дублируя публичный контракт мимо корневого barrel для внешних потребителей.

package/presets/claude/next/rules/api-and-data/http-client.md

@@ -1,40 +0,0 @@
----
-paths:
-  - app/src/lib/clients/**/*.ts
-  - app/src/api/clients/**/*.ts
----
-
-# HTTP-транспорт
-
-**Имена** фабрик, классов ошибок, типов ответа и конфига — **как в текущем коде репозитория** и в barrel `app/src/types/index.ts`. Ниже — **архитектурные правила**, а не спецификация переименований.
-
-## Роль слоя
-
-- Обычные REST‑вызовы к backend идут через **одну реализацию** в `app/src/lib/clients/**` (модуль общего клиента) и **преднастроенные экземпляры** в `app/src/api/clients/**`, по тому же паттерну, что уже принят в проекте.
-- Место транспорта в общей картине **порты и адаптеры** — в `architecture/architecture-boundaries.md` (раздел **«Порты и адаптеры»**).
-- **Не** вызывать `fetch` напрямую из `app/src/api/services/**`, store и UI (см. `architecture/architecture-boundaries.md`, `api-and-data/api-services.md`); из store/UI — только вызовы через сервисы из `@/api` (`architecture/public-imports.md`).
-- **Исключения** (узкие протоколы, отдельный транспорт) — только там, где в репозитории уже есть образец; повторять его, не плодить произвольные обходы общего клиента.
-
-## Типы
-
-- Всё, что относится к **контракту запроса/ответа/ошибки** приложения и реэкспортируется для HTTP‑слоя, импортировать **только** из barrel `@/types`, без deep‑импортов из внутренних файлов `app/src/types/**` (см. `architecture/public-imports.md`).
-- Не поднимать в новом коде **типы и зависимости от внешнего HTTP‑клиента**, от которого проект ушёл; ориентир — **`package.json`** и существующие вызовы.
-
-## Контракт ошибок
-
-- Ошибки сети и HTTP должны приходить в **едином виде**, который задаёт общий клиент (обычно класс/обёртка с полем вроде `response` для тела и статуса).
-- В **`catch`** ориентироваться на **фактическую форму** ошибки в этом репозитории (как в соседних слайсах/сервисах): доступ к телу ошибки, статусу, диагностическому коду — **по полям текущей реализации**, без выдумывания второго формата.
-
-## Поведение, которое остаётся в клиенте
-
-- Общие заголовки, `credentials`, загрузка файлов (**FormData** / снятие лишних заголовков), бинарные ответы (**blob** и аналоги), единообразный разбор JSON и прочих тел.
-- Перехват **401 / refresh**, обработка **404** и т.п. — **централизованно**, если так уже сделано в клиенте; не дублировать ту же логику в каждом сервисе.
-
-## Связь со store
-
-- Thunk может возвращать **тип обёртки успешного ответа**, если сервис так устроен; в **state** по возможности класть **доменные** типы после маппинга. Подробнее — `api-and-data/store-rtk.md`.
-
-## Требование к агенту
-
-- Меняя реализацию общего клиента — **обновить или добавить behavior‑тесты** рядом с модулем клиента (`testing/tests-unit.md`).
-- Не вводить **второй полноценный HTTP‑стек** без явной задачи и согласования с архитектурой репозитория.

package/presets/claude/next/rules/api-and-data/store-rtk.md

@@ -1,65 +0,0 @@
----
-paths:
-  - app/src/store/**/*.ts
----
-
-# Общие принципы
-
-- Использовать **Redux Toolkit**:
-  - `createSlice`, `createAsyncThunk`, RTK Query (если используется).
-- Хранить в store **доменные модели**, не «сырые» DTO из API.
-- Все вычисления и преобразования данных (включая вычисляемые поля, булевые флаги, агрегаты, человеко‑читаемые строки и т.п.) должны выполняться **между ответом API и записью в store** — в мапперах или отдельном слое подготовки данных. Store хранит уже подготовленную доменную модель.
-- Разделять:
-  - «серверное» состояние (данные из API) и
-  - локальное UI‑состояние (выбор/фильтры/флаги).
-
-# Структура слайсов
-
-- Каждый доменный модуль — свой слайс в `app/src/store/slices/**`.
-- Слайс экспортирует:
-  - `reducer` по умолчанию;
-  - `actions` именованным экспортом;
-  - селекторы `selectSomething(state: RootState): Type`.
-- Состояние:
-  - явный тип для state;
-  - аккуратная инициализация initialState.
-
-# Асинхронность и сайд‑эффекты
-
-- Асинхронные запросы:
-  - через `createAsyncThunk` или RTK Query.
-  - внутри thunk:
-    - вызывать API через сервисы, импортированные из `@/api` (**`architecture/public-imports.md`**);
-    - не вызывать HTTP‑клиент напрямую — только через эти сервисы.
-- Сайд‑эффекты (логирование, аналитика, работа с файлами):
-  - выносить в middleware (`app/src/store/middleware/**`) или специализированные слайсы.
-
-# Типизация
-
-- Использовать `RootState`, `AppDispatch` и типизированные хуки `useAppDispatch`, `useAppSelector` (если есть).
-- **HTTP и ошибки API**:
-  - не импортировать типы **сторонних HTTP‑библиотек**, которых нет в актуальных зависимостях и существующих слайсах (ориентир — **`package.json`** и соседние файлы);
-  - когда сервис возвращает **обёртку ответа** прикладного клиента — использовать **соответствующий тип из `@/types`** (как в barrel и в аналогичных thunk’ах);
-  - при ошибках после вызова сервиса — опираться на **тот же класс/контракт ошибки транспорта**, что использует общий клиент (из `@/types`), и разбирать тело/статус **по полям текущей реализации**, а не по воображаемому API;
-  - в **`catch`** предпочитать **`instanceof`** на класс ошибки транспорта из `@/types` (если он есть в коде) вместо голого `as`, когда это выразимо без шума (см. `stack/no-type-assertion.md`).
-- Для сущностей:
-  - доменные типы (включая вычисляемые поля) определять в `app/src/types/**`, экспортировать через barrel и импортировать в слайсы из `@/types` как **источник правды** (`architecture/public-imports.md`);
-  - избегать дублирования описаний сущностей в нескольких местах.
-- **Граница домена**: в **state** хранить доменные модели; тип **обёртки ответа клиента** допустим как тип **возвращаемого значения thunk** или промежуточно до маппинга — без дублирования DTO в полях state без нужды (согласовано с `api-and-data/api-services.md` и `api-and-data/http-client.md`).
-
-# Тестирование слайсов
-
-- Для важных слайсов:
-  - тестировать редюсеры (инициализация, основные переходы состояний);
-  - тестировать селекторы (включая edge cases).
-- Thunk’и:
-  - по возможности покрывать тестами с моками API‑слоя.
-
-# Требование к агенту
-
-При изменении/создании слайса:
-
-- Не класть логику API внутрь редюсеров/компонентов.
-- Строго типизировать state и actions.
-- Использовать **единый стиль именования actions и селекторов**, как в существующих слайсах.
-- При работе с ошибками и ответами HTTP опираться на **`api-and-data/http-client.md`** и контракты из `@/types`, а не на типы внешних HTTP‑библиотек вне зависимостей проекта.

package/presets/claude/next/rules/architecture/api-public-imports.md

@@ -1,8 +0,0 @@
----
-paths:
-  - app/src/api/**/*
----
-
-# Deprecated
-
-Содержимое перенесено в **`architecture/public-imports.md`** (раздел `@/api`).