@bonesofspring/ai-rules 0.1.40 → 0.1.42

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

@@ -1,6 +1,5 @@
 #!/usr/bin/env bash
 # Chains agent team phases after subagent completion when wired into Claude Code hooks.
-# Reads stdin JSON from a subagent-stop style hook; writes followup_message to stdout.
 
 set -euo pipefail
 
@@ -10,6 +9,8 @@ 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 {
@@ -24,8 +25,7 @@ if (hookInput.status !== 'completed') {
   process.exit(0);
 }
 
-const teamRoot = path.join(process.cwd(), '.claude', 'team');
-const activePath = path.join(teamRoot, 'active-task.json');
+const activePath = path.join(TEAM_ROOT, 'active-task.json');
 
 if (!fs.existsSync(activePath)) {
   process.stdout.write('{}');
@@ -46,7 +46,10 @@ if (!slug) {
   process.exit(0);
 }
 
-const statusPath = path.join(teamRoot, 'tasks', slug, 'status.json');
+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);
@@ -63,61 +66,277 @@ try {
 const now = new Date().toISOString();
 
 function writeStatus(next) {
-  fs.writeFileSync(statusPath, JSON.stringify({ ...status, ...next, slug, updatedAt: now }, null, 2) + '\n');
+  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 }));
 }
 
-// Human gate: do not auto-chain during analysis or explicit approval waits.
-if (status.phase === 'analysis' || status.state === 'awaiting_approval') {
+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);
 }
 
-// Legacy mode without pipeline.json.
-if (status.phase === 'development' && status.state === 'completed') {
-  writeStatus({ phase: 'review', state: 'in_progress' });
-  out(
-    `Subagent development phase finished for slug "${slug}". ` +
-      `Invoke the code-reviewer subagent. ` +
-      `Read .claude/team/tasks/${slug}/brief.md and decomposition.md. ` +
-      `Review git diff against acceptance criteria per rules/tooling-and-review/code-review-mr.md. ` +
-      `Update status.json when done.`,
-  );
+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.phase === 'review' && status.state === 'completed') {
-  writeStatus({ phase: 'testing', state: 'in_progress' });
-  out(
-    `Code review completed for slug "${slug}". ` +
-      `Invoke the qa-tester subagent. ` +
-      `Add or update unit and e2e tests per brief acceptance criteria. ` +
-      `Follow rules/testing/playwright-agents.md and rules/testing/tests-e2e-structure.md. ` +
-      `Update status.json when done.`,
-  );
+if (status.awaitingHumanGate || status.state === 'awaiting_approval') {
+  process.stdout.write('{}');
   process.exit(0);
 }
 
-if (status.phase === 'review' && status.state === 'changes_requested') {
-  out(
-    `Review requested changes for slug "${slug}". ` +
-      `Invoke feature-developer with the review fix list, then re-run code-reviewer.`,
-  );
+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.phase === 'testing' && status.state === 'completed') {
-  writeStatus({ phase: 'done', state: 'completed' });
-  out(
-    `QA phase completed for slug "${slug}". ` +
-      `Suggest running /technical-retro with this slug. ` +
-      `Read team artifacts under .claude/team/tasks/${slug}/ and git diff for the retro.`,
-  );
+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);
 }
 
-process.stdout.write('{}');
+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

@@ -0,0 +1,77 @@
+#!/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/README.md

@@ -1,54 +1,30 @@
 # `.claude/rules` (preset next)
 
-В Claude Code все `.md` под `rules/` **обнаруживаются рекурсивно**. Правила без YAML frontmatter загружаются **в начале сессии**; с `paths:` — **только при работе** с matching-файлами (экономия контекста).
+В Claude Code все `.md` под `rules/` **обнаруживаются рекурсивно**. Правила без YAML frontmatter загружаются **в начале сессии**; с `paths:` — **только при работе** с matching-файлами.
 
-Соответствие пресету Cursor (`.cursor/rules/*.mdc`):
+## Loading strategy
 
-| Папка | О чём | Загрузка |
-|-------|--------|----------|
-| `architecture/` | границы слоёв, barrel, импорты, доставка фичи | session start |
-| `stack/` | Next.js, TS, навигация, JSDoc типов | core — session; `types-jsdoc.md` — `paths: app/src/types/**` |
-| `api-and-data/` | HTTP, сервисы, store | `paths:` по каталогам слоя |
-| `ui-and-accessibility/` | React UI, стили, a11y, пропсы | core — session; `react-ui.md` — `paths: app/src/ui/**` |
-| `testing/` | unit, e2e, Playwright agents | `tests-unit.md`, `tests-e2e-structure.md` — `paths:`; `playwright-agents.md` — session start |
-| `tooling-and-review/` | lint, package manager, качество, MR review | session start |
+- **Session start (no `paths:`):** `next-app-core`, `post-change-lint`, `package-manager`, `agent-team-intake`, `code-quality`, orchestrator
+- **`paths:` on-demand:** architecture, imports, UI, tests, feature-delivery-workflow, reference-features, next-app-router, react-a11y-coding
+- **Skills:** long workflows (`feature-delivery`, `code-review`, …)
 
-On-demand сценарии вне постоянного контекста — в `commands/` (например `technical-retro.md`).
+## С чего начать
 
-## С чего начать новую фичу
+- **`commands/task.md`** — router → `pipeline.json` → agents
+- **`architecture/reference-features.md`** — заполнить TBD после init
+- **`architecture/feature-delivery-workflow.md`** — порядок слоёв
 
-Для обычной задачи — **`commands/task.md`**: router → `pipeline.json` → нужные agents. Для ручной реализации без team workflow — **`architecture/feature-delivery-workflow.md`**.
-
-## Каталог правил
+## Каталог (новые и ключевые)
 
 | Файл | Назначение |
 |------|------------|
-| `tooling-and-review/package-manager.md` | Менеджер пакетов перед install/run |
-| `tooling-and-review/agent-team-intake.md` | Когда использовать `/task` и task-router |
-| `tooling-and-review/agent-team-orchestrator.md` | Dynamic pipeline, subagents, gates, handoff artifacts |
-| `architecture/feature-delivery-workflow.md` | Сквозной порядок работ по фиче, mermaid, матрица слой → правило |
-| `stack/next-app-core.md` | Стек, слои, порты‑адаптеры, работа агента |
-| `tooling-and-review/post-change-lint.md` | **Обязательный** ESLint + Stylelint после изменений |
-| `architecture/architecture-boundaries.md` | Границы UI / store / API, импорты, фича как срез |
-| `api-and-data/http-client.md` | Единый HTTP‑стек, контракты из `@/types` |
-| `api-and-data/api-services.md` | Сервисы, мапперы, прикладные API‑клиенты |
-| `api-and-data/store-rtk.md` | Redux Toolkit, thunk’и, типизация ошибок |
-| `architecture/types-public-imports.md` | Импорты только через barrel `@/types` |
-| `architecture/api-public-imports.md` | Импорты только через barrel `@/api` |
-| `architecture/layer-barrel-exports.md` | Двухуровневые barrel для слоёв с public API |
-| `stack/types-jsdoc.md` | JSDoc для типов в `app/src/types` |
-| `stack/no-type-assertion.md` | Ограничение `as`, `instanceof` для ошибок транспорта |
-| `tooling-and-review/code-review-mr.md` | Чеклист ревью MR |
-| `testing/tests-unit.md` | Unit‑тесты и behavior‑тесты HTTP‑клиента |
-| `testing/playwright-agents.md`, `testing/tests-e2e-structure.md` | E2e |
-| `ui-and-accessibility/react-ui.md` | React/Next UI: структура, `.data.ts` / `.utils.ts`, стили |
-| `ui-and-accessibility/no-props-spread.md` | Без spread пропов в компонентах |
-| `ui-and-accessibility/component-styles.md` | Колокация стилей, `Root` |
-| `ui-and-accessibility/css-property-order.md` | Порядок CSS (Stylelint) |
-| `stack/arrow-functions.md` | Стрелочные функции |
-| `stack/navigation-router.md` | Навигация по стеку проекта |
-| `tooling-and-review/code-quality.md` | Качество кода и рефакторинг |
-
-**Коллизии:** импорт типов — **`architecture/types-public-imports.md`**; импорт API вне `app/src/api/**` — **`architecture/api-public-imports.md`**.
-
-Задачи на **сеть, HTTP, эндпоинты**: **`api-and-data/http-client.md`** + **`api-and-data/api-services.md`** + **`api-and-data/store-rtk.md`**.
+| `architecture/reference-features.md` | Эталонные пути UI/store/API |
+| `stack/next-app-router.md` | App Router, RSC |
+| `ui-and-accessibility/react-a11y-coding.md` | A11y при кодинге UI |
+| `architecture/feature-delivery-workflow.md` | Сквозной чеклист (paths) |
+| `tooling-and-review/agent-team-orchestrator.md` | Pipeline, build-verifier, parallel |
+| `agents/build-verifier.md` | Validation gate agent |
+
+Полный список — см. подпапки `architecture/`, `stack/`, `api-and-data/`, `ui-and-accessibility/`, `testing/`, `tooling-and-review/`.
+
+**Коллизии:** импорт типов — `architecture/types-public-imports.md`; API вне `app/src/api/**` — `architecture/api-public-imports.md`.

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

@@ -1,3 +1,9 @@
+---
+paths:
+  - app/src/**/*.ts
+  - app/src/**/*.tsx
+---
+
 # Импорты из `@/api`
 
 - **Публичный API слоя API** — barrel `app/src/api/index.ts`. Для файлов **вне** `app/src/api/**` импортировать сервисы, клиенты, эндпоинты и публичные типы API **только** как `import … from '@/api'` (или `from '@/api/index'` при необходимости явного пути).

package/presets/claude/next/rules/architecture/architecture-boundaries.md

@@ -1,3 +1,8 @@
+---
+paths:
+  - app/src/**/*
+---
+
 # Границы между слоями
 
 ## UI (`app/src/ui/**`)

package/presets/claude/next/rules/architecture/feature-delivery-workflow.md

@@ -1,3 +1,8 @@
+---
+paths:
+  - app/src/**/*
+---
+
 # Доставка фичи (сквозной порядок)
 
 Типичная фича с данными с backend и общим состоянием. Детали слоёв — в `architecture/architecture-boundaries.md`, `stack/next-app-core.md`.

package/presets/claude/next/rules/architecture/layer-barrel-exports.md

@@ -1,3 +1,8 @@
+---
+paths:
+  - app/src/**/*
+---
+
 # Barrel-экспорты слоёв с public API
 
 ## Когда применять

package/presets/claude/next/rules/architecture/reference-features.md

@@ -0,0 +1,34 @@
+---
+paths:
+  - app/src/**/*
+---
+
+# Эталонные фичи (reference features)
+
+Перед реализацией найди фичу того же типа и **повтори её структуру**, не изобретая новую организацию файлов.
+
+## Таблица эталонов
+
+Замени **TBD** на реальные пути после договорённости в команде (или при `ai-rules init` в целевом репо):
+
+| Слой | Эталон | Что копировать |
+|------|--------|----------------|
+| UI page | **TBD** `app/src/ui/pages/<Example>/` | `components/`, `*.data.ts`, `styles.ts`, barrel |
+| Store slice | **TBD** `app/src/store/slices/<example>/` | slice, thunks, selectors, types |
+| API service | **TBD** `app/src/api/services/<example>/` | service, mappers, barrel |
+| Types module | **TBD** `app/src/types/<example>/` | domain types, JSDoc, barrel export |
+| Unit tests | **TBD** рядом с эталонным mapper/service | `*.spec.ts`, describe/it naming |
+| E2E area | **TBD** `app/__tests__/e2e/<Area>/` | `*.cases.md`, page objects, `_shared/` |
+
+## Как использовать
+
+1. Определи затронутые слои из `decomposition.md` или задачи.
+2. Открой эталон из таблицы (после заполнения путей).
+3. Зеркаль именование, порядок файлов, паттерны импортов и тестов.
+4. Если эталона нет — выбери **самую близкую** существующую фичу того же слоя и зафиксируй выбор в handoff.
+
+## Связанные правила
+
+- `tooling-and-review/code-quality.md` — повторять паттерны, не deep-import.
+- `architecture/feature-delivery-workflow.md` — порядок слоёв.
+- skill `feature-delivery` — end-to-end сценарий.

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

@@ -1,3 +1,9 @@
+---
+paths:
+  - app/src/**/*.ts
+  - app/src/**/*.tsx
+---
+
 # Импорты из `@/types`
 
 - **Публичный API типов** — barrel `app/src/types/index.ts`, импортировать типы и интерфейсы только как `@/types` (или `@/types/index` при необходимости явного пути).

package/presets/claude/next/rules/stack/arrow-functions.md

@@ -1,3 +1,8 @@
+---
+paths:
+  - app/src/**/*.{ts,tsx,js,jsx}
+---
+
 # Стрелочные функции
 
 При разработке **использовать стрелочный синтаксис** для функций, где это допустимо в TypeScript/JavaScript.

package/presets/claude/next/rules/stack/navigation-router.md

@@ -1,3 +1,8 @@
+---
+paths:
+  - app/src/ui/**/*
+---
+
 # Навигация и роутинг: сначала стек проекта
 
 **При любой задаче, связанной с навигацией, переходами между страницами, URL, редиректами, хлебными крошками, защищёнными маршрутами или программной сменой маршрута** — перед предложением кода или импортов **нельзя** опираться на «типичный React» по умолчанию. Нужно **явно свериться со стеком целевого репозитория** и использовать **один** согласованный с проектом механизм.

package/presets/claude/next/rules/stack/next-app-router.md

@@ -0,0 +1,36 @@
+---
+paths:
+  - app/src/app/**/*
+  - app/**/app/**/*
+---
+
+# Next.js App Router
+
+Применять при работе с `app/src/app/**` или маршрутами App Router в целевом репо.
+
+## Server vs Client
+
+- **Server Components по умолчанию** — без `'use client'`, если не нужны hooks, browser API, event handlers.
+- **`'use client'`** — только для интерактива, `useState`/`useEffect`, browser-only API.
+- Не тянуть store/RTK и тяжёлый client-state в Server Components без необходимости.
+
+## Data fetching
+
+- Предпочитать fetch/data-loader на **server** (RSC, route handlers, server actions — по принятому в репо паттерну).
+- **Не дублировать** один запрос в RSC и client без причины.
+- Кеш и revalidate — как в существующих страницах репо (`fetch` options, `revalidate`, tags).
+
+## Маршруты и UX
+
+- Для async routes использовать **`loading.tsx`**, **`error.tsx`**, **`not-found.tsx`** по образцу соседних routes.
+- **Suspense** — для медленных client/server секций; fallback согласован с дизайн-системой.
+- Навигация — `stack/navigation-router.md` + router/link паттерны проекта.
+
+## Границы слоёв
+
+- RSC/route handlers **не импортируют UI-компоненты с client-only зависимостями** напрямую в server tree без `'use client'` границы.
+- Доменные типы — `@/types`; вызовы backend — через `@/api` / services, не raw `fetch` из page.tsx без слоя API.
+
+## Эталон
+
+Смотри существующий route той же сложности в `app/src/app/**` и повтори структуру (`architecture/reference-features.md`).

package/presets/claude/next/rules/stack/no-type-assertion.md

@@ -1,3 +1,9 @@
+---
+paths:
+  - app/src/**/*.ts
+  - app/src/**/*.tsx
+---
+
 # Не использовать `as` для приведения типов при экспорте и импорте
 
 ## О чём речь