@michaelbel/cuckcoder-mcp 1.6.12 → 1.6.14

package/assets/workflows/business-feature-sweep.js

@@ -0,0 +1,218 @@
+export const meta = {
+  name: 'business-feature-sweep',
+  description:
+    'Реализация фичи целиком: параллельный research (архитектура/UX/security/бизнес/ ' +
+    'devops), план, DoD/DoR-спека, параллельная реализация по платформам в ' +
+    'изолированных worktree на feature-ветке и валидация сборки/тестов против спеки.',
+  whenToUse: 'Новая фича, новый экран, новый endpoint — новая фича, новый экран, доработка.',
+}
+
+// ── args ────────────────────────────────────────────────────────────────
+//   request    : описание фичи от пользователя (обязателен)
+//   baseBranch : ветка, от которой бранчеваться (по умолчанию 'main')
+const A = typeof args === 'string' ? JSON.parse(args) || {} : args || {}
+const REQUEST = A.request || ''
+const BASE_BRANCH = A.baseBranch || 'main'
+
+if (!REQUEST) {
+  return { status: 'skipped', reason: 'Не передано описание фичи.' }
+}
+
+phase('Research')
+const lenses = [
+  {
+    role: 'architecture',
+    agentType: 'cuckcoder:architect-auditor',
+    focus:
+      'как эта фича впишется в существующие границы модулей, слои и ' +
+      'зависимости без нарушения инвариантов',
+  },
+  {
+    role: 'ux',
+    agentType: 'cuckcoder:ux-reviewer',
+    focus:
+      'необходимые визуальные состояния (loading/empty/error/offline/populated), ' +
+      'навигация, accessibility и консистентность с соседними экранами',
+  },
+  {
+    role: 'security',
+    agentType: 'cuckcoder:security-auditor',
+    focus: 'авторизация, валидация ввода, секреты и другие риски, которые вносит эта фича',
+  },
+  {
+    role: 'business',
+    agentType: 'cuckcoder:business-analyst',
+    focus:
+      'scope, ожидаемые пользователи, критерии успеха и любая неоднозначность ' +
+      'или пропущенные acceptance criteria в запросе',
+  },
+  {
+    role: 'devops',
+    agentType: 'cuckcoder:devops-expert',
+    focus: 'конфигурация, feature flags, окружения и вопросы rollout/релиза',
+  },
+]
+
+const findings = await parallel(
+  lenses.map((l) => () =>
+    agent(
+      `Запрос на фичу: "${REQUEST}". Твоя линза — ${l.role}: ${l.focus}.
+       Исследуй кодовую базу (read, grep) на предмет того, что важно для
+       этой фичи с твоей точки зрения. Верни analysis, concerns/риски и
+       конкретные recommendations.`,
+      {
+        label: `research:${l.role}`,
+        phase: 'Research',
+        agentType: l.agentType,
+        schema: {
+          type: 'object',
+          required: ['analysis', 'concerns', 'recommendations'],
+          properties: {
+            analysis: { type: 'string' },
+            concerns: { type: 'array', items: { type: 'string' } },
+            recommendations: { type: 'array', items: { type: 'string' } },
+          },
+        },
+      },
+    ),
+  ),
+)
+
+phase('Plan')
+const plan = await agent(
+  `Собери план реализации фичи "${REQUEST}" по этому research:
+   ${JSON.stringify(findings.filter(Boolean))}
+   Дай пошаговые steps, какие слои платформы затронуты (shared-kotlin,
+   android-compose, ios-swift, ios-swiftui — любое подмножество) и
+   ключевые риски.`,
+  {
+    label: 'plan',
+    phase: 'Plan',
+    schema: {
+      type: 'object',
+      required: ['steps', 'affectedLayers', 'risks'],
+      properties: {
+        steps: { type: 'array', items: { type: 'string' } },
+        affectedLayers: {
+          type: 'array',
+          items: {
+            type: 'string',
+            enum: ['shared-kotlin', 'android-compose', 'ios-swift', 'ios-swiftui'],
+          },
+        },
+        risks: { type: 'array', items: { type: 'string' } },
+      },
+    },
+  },
+)
+
+phase('Spec')
+const spec = await agent(
+  `Напиши контракт приёмки для фичи "${REQUEST}".
+   План: ${JSON.stringify(plan)}
+   UX-research: ${JSON.stringify(findings.find((f) => f))}
+   Дай: DoD (что значит "готово"), DoR (что должно быть готово до старта),
+   каждое обязательное визуальное состояние (loading, empty, error,
+   offline, populated), edge cases и бизнес-правила/инварианты. Ничто в
+   Executing не может пропустить состояние или edge case из этого списка.`,
+  {
+    label: 'spec',
+    phase: 'Spec',
+    agentType: 'cuckcoder:business-analyst',
+    schema: {
+      type: 'object',
+      required: ['dod', 'dor', 'states', 'edgeCases'],
+      properties: {
+        dod: { type: 'array', items: { type: 'string' } },
+        dor: { type: 'array', items: { type: 'string' } },
+        states: {
+          type: 'object',
+          properties: {
+            loading: { type: 'string' },
+            empty: { type: 'string' },
+            error: { type: 'string' },
+            offline: { type: 'string' },
+            populated: { type: 'string' },
+          },
+        },
+        edgeCases: { type: 'array', items: { type: 'string' } },
+      },
+    },
+  },
+)
+
+phase('Executing')
+const affectedLayers =
+  plan.affectedLayers && plan.affectedLayers.length ? plan.affectedLayers : ['shared-kotlin']
+const layerAgents = {
+  'shared-kotlin': 'cuckcoder:kotlin-engineer',
+  'android-compose': 'cuckcoder:compose-builder',
+  'ios-swift': 'cuckcoder:swift-engineer',
+  'ios-swiftui': 'cuckcoder:swiftui-builder',
+}
+
+const branchSlug = REQUEST.toLowerCase()
+  .replace(/[^a-z0-9]+/g, '-')
+  .slice(0, 40)
+  .replace(/(^-|-$)/g, '')
+
+const execResults = await parallel(
+  affectedLayers.map((layer) => () =>
+    agent(
+      `Реализуй свою часть фичи "${REQUEST}" на слое "${layer}".
+       Ветвись от origin/${BASE_BRANCH}: git fetch origin ${BASE_BRANCH} &&
+       git checkout -b feature/${branchSlug} origin/${BASE_BRANCH}.
+       План: ${JSON.stringify(plan)}
+       Спека (DoD/DoR): ${JSON.stringify(spec)}
+       Реализуй каждое состояние и edge case из спеки, а не только happy
+       path. Верни изменённые файлы и summary реализованного.`,
+      {
+        label: `execute:${layer}`,
+        phase: 'Executing',
+        agentType: layerAgents[layer] || 'cuckcoder:kotlin-engineer',
+        isolation: 'worktree',
+        schema: {
+          type: 'object',
+          required: ['changedFiles', 'summary'],
+          properties: {
+            changedFiles: { type: 'array', items: { type: 'string' } },
+            summary: { type: 'string' },
+          },
+        },
+      },
+    ),
+  ),
+)
+
+phase('Validate')
+const changedFiles = execResults.filter(Boolean).flatMap((r) => r.changedFiles || [])
+const validation = await agent(
+  `Провалидируй фичу "${REQUEST}". Изменённые файлы: ${JSON.stringify(changedFiles)}.
+   Спека: ${JSON.stringify(spec)}.
+   Собери проект и запусти тесты. Затем сверь со спекой: реализовано ли
+   каждое перечисленное состояние и edge case? Верни passed, buildPassed,
+   dodChecked (boolean) и details.`,
+  {
+    label: 'validate',
+    phase: 'Validate',
+    agentType: 'cuckcoder:build-engineer',
+    schema: {
+      type: 'object',
+      required: ['passed', 'buildPassed', 'dodChecked', 'details'],
+      properties: {
+        passed: { type: 'boolean' },
+        buildPassed: { type: 'boolean' },
+        dodChecked: { type: 'boolean' },
+        details: { type: 'string' },
+      },
+    },
+  },
+)
+
+return {
+  status: validation && validation.passed ? 'done' : 'partial',
+  plan,
+  spec,
+  execResults: execResults.filter(Boolean),
+  validation,
+}

package/assets/workflows/full-review.js

@@ -0,0 +1,190 @@
+export const meta = {
+  name: 'full-review',
+  description:
+    'Мульти-линзовое ревью диффа, ветки или PR: собирает изменение, параллельно ' +
+    'прогоняет correctness/security/performance/architecture/UX-ревью и сводит ' +
+    'всё в один приоритизированный отчёт.',
+  whenToUse:
+    'Полное ревью изменений или GitHub PR перед мёрджем — code-review, ревью PR, ' +
+    'отревьюй диф.',
+}
+
+// ── args ────────────────────────────────────────────────────────────────
+//   target       : 'branch' (по умолчанию, дифф от base) | 'staged' | 'pr:<N>'
+//   base         : базовая ветка для target='branch' (по умолчанию 'main')
+//   postComments : постить ли инлайн-комменты в PR (только при target='pr:<N>',
+//                  по умолчанию false)
+const A = typeof args === 'string' ? JSON.parse(args) || {} : args || {}
+const TARGET = A.target || 'branch'
+const BASE = A.base || 'main'
+const POST_COMMENTS = !!A.postComments
+
+const PR_MATCH = /^pr:(.+)$/.exec(TARGET)
+const PR_NUMBER = PR_MATCH ? PR_MATCH[1] : null
+
+const diffCmd = PR_NUMBER
+  ? `gh pr diff ${PR_NUMBER} (файлы: gh pr diff ${PR_NUMBER} --name-only; метаданные: ` +
+    `gh pr view ${PR_NUMBER} --json title,body,baseRefName,headRefName,files)`
+  : TARGET === 'staged'
+    ? 'git diff --staged (файлы: git diff --staged --name-only)'
+    : `git diff ${BASE}..HEAD (файлы: git diff ${BASE}..HEAD --name-only)`
+
+phase('Diff')
+const diff = await agent(
+  `Собери набор изменений для этого ревью. Target: ${TARGET}.
+   Выполни: ${diffCmd}.
+   Верни hasChanges, краткое summary того, что делает изменение (title/description
+   из "gh pr view", если это PR), список изменённых файлов и сам unified diff
+   (при большом объёме — усеки, оставив содержательные хунки). Ничего не меняй —
+   только сбор данных.`,
+  {
+    label: 'collect-diff',
+    phase: 'Diff',
+    model: 'sonnet',
+    schema: {
+      type: 'object',
+      required: ['hasChanges', 'summary', 'files'],
+      properties: {
+        hasChanges: { type: 'boolean' },
+        summary: { type: 'string' },
+        files: { type: 'array', items: { type: 'string' } },
+        diff: { type: 'string' },
+      },
+    },
+  },
+)
+
+if (!diff || diff.hasChanges === false || !(diff.files && diff.files.length)) {
+  return { status: 'no-changes', target: TARGET, findings: [] }
+}
+
+phase('Review')
+const FINDING_SCHEMA = {
+  type: 'object',
+  required: ['severity', 'location', 'summary', 'fix'],
+  properties: {
+    severity: { type: 'string', enum: ['critical', 'high', 'medium', 'low', 'info'] },
+    location: { type: 'string' },
+    summary: { type: 'string' },
+    fix: { type: 'string' },
+  },
+}
+
+const lenses = [
+  { dimension: 'correctness', agentType: 'cuckcoder:code-reviewer' },
+  { dimension: 'security', agentType: 'cuckcoder:security-auditor' },
+  { dimension: 'performance', agentType: 'cuckcoder:performance-reviewer' },
+  { dimension: 'architecture', agentType: 'cuckcoder:architect-auditor' },
+  { dimension: 'ux', agentType: 'cuckcoder:ux-reviewer' },
+]
+
+const perDimension = await parallel(
+  lenses.map((lens) => () =>
+    agent(
+      `Проревьюй этот дифф только в зоне своей ответственности. Не повторяй
+       находки, относящиеся к другой дисциплине.
+
+       Summary изменения: ${diff.summary}
+       Изменённые файлы: ${JSON.stringify(diff.files)}
+       Diff: ${diff.diff || '(прочитай сам через ' + diffCmd + ')'}
+
+       Указывай только находки, которые видны конкретно в диффе. Если сказать
+       нечего — верни пустой массив, не выдумывай общие советы.`,
+      {
+        label: `review:${lens.dimension}`,
+        phase: 'Review',
+        agentType: lens.agentType,
+        schema: {
+          type: 'object',
+          required: ['findings'],
+          properties: { findings: { type: 'array', items: FINDING_SCHEMA } },
+        },
+      },
+    ).then((result) =>
+      result ? result.findings.map((f) => ({ dimension: lens.dimension, ...f })) : [],
+    ),
+  ),
+)
+
+const findings = perDimension.flat()
+
+phase('Synthesize')
+let synthesis = {
+  verdict: 'APPROVE',
+  findings: [],
+  summary: 'Находок нет ни по одному из пяти направлений ревью.',
+}
+if (findings.length > 0) {
+  synthesis = await agent(
+    `Вот находки из пяти независимых ревью (correctness, security, performance,
+     architecture, UX) одного и того же диффа:
+
+     ${JSON.stringify(findings, null, 2)}
+
+     Объедини дублирующиеся или пересекающиеся находки (оставь максимальный
+     severity и перечисли все направления-источники), убери всё, что не
+     вызвано этим диффом, отсортируй по severity и напиши короткое
+     приоритизированное summary. Правило verdict: любая critical или high
+     находка → REQUEST_CHANGES; только medium/low → COMMENT; только info
+     или пусто → APPROVE.`,
+    {
+      label: 'synthesize',
+      phase: 'Synthesize',
+      schema: {
+        type: 'object',
+        required: ['verdict', 'findings', 'summary'],
+        properties: {
+          verdict: { type: 'string', enum: ['APPROVE', 'COMMENT', 'REQUEST_CHANGES'] },
+          findings: {
+            type: 'array',
+            items: {
+              type: 'object',
+              required: ['severity', 'location', 'summary', 'fix', 'dimensions'],
+              properties: {
+                severity: { type: 'string' },
+                location: { type: 'string' },
+                summary: { type: 'string' },
+                fix: { type: 'string' },
+                dimensions: { type: 'array', items: { type: 'string' } },
+              },
+            },
+          },
+          summary: { type: 'string' },
+        },
+      },
+    },
+  )
+}
+
+let commentResult = null
+if (POST_COMMENTS && PR_NUMBER && synthesis.findings.length > 0) {
+  phase('Comment')
+  commentResult = await agent(
+    `Запости это ревью инлайн-комментариями в PR #${PR_NUMBER} через gh CLI.
+     Находки: ${JSON.stringify(synthesis.findings)}.
+     Для каждой находки добавь инлайн-коммент на file:line через
+     "gh api repos/:owner/:repo/pulls/${PR_NUMBER}/comments" (или
+     "gh pr review ${PR_NUMBER} --comment" со сводным телом, если инлайн-позиция
+     не резолвится). Формат тела: "[severity][dimensions] summary → fix".
+     НЕ аппрувь, не мёрджи, не пуш и не меняй код — только оставляй
+     ревью-комментарии. Верни posted (boolean) и details.`,
+    {
+      label: 'comment-pr',
+      phase: 'Comment',
+      schema: {
+        type: 'object',
+        required: ['posted', 'details'],
+        properties: { posted: { type: 'boolean' }, details: { type: 'string' } },
+      },
+    },
+  )
+}
+
+return {
+  status: 'reviewed',
+  target: TARGET,
+  verdict: synthesis.verdict,
+  summary: synthesis.summary,
+  findings: synthesis.findings,
+  comments: commentResult,
+}

package/assets/workflows/mvi-compliance-sweep.js

@@ -0,0 +1,74 @@
+export const meta = {
+  name: 'mvi-compliance-sweep',
+  description:
+    'Параллельная проверка каждого ViewModel и Screen на соответствие MVI-правилам ' +
+    'этого репозитория с конкретными, обоснованными правилом нарушениями.',
+}
+
+const discovery = await agent(
+  `Найди каждую MVI-фичу в этом проекте: для каждой фичи — её ViewModel,
+   её Screen (Composable) и определения Intent/Model/Event/State, если
+   они вынесены в отдельные файлы. Сгруппируй их по фиче. Верни по одной
+   записи на фичу с её именем и списком относительных путей к файлам.`,
+  {
+    schema: {
+      type: 'object',
+      required: ['features'],
+      properties: {
+        features: {
+          type: 'array',
+          items: {
+            type: 'object',
+            required: ['name', 'files'],
+            properties: {
+              name: { type: 'string' },
+              files: { type: 'array', items: { type: 'string' } },
+            },
+          },
+        },
+      },
+    },
+  },
+)
+
+const perFeature = await pipeline(discovery.features, (feature) =>
+  agent(
+    `Вызови MCP-инструмент cuckcoder "get_rule" с именами "android/MVI_RULES",
+     "android/MVI_STATE_RULES" и "android/MVI_ERROR_HANDLING_RULES", чтобы
+     получить актуальные MVI-правила проекта. Затем проверь по этим
+     правилам только файлы фичи "${feature.name}":
+
+     ${feature.files.join('\n')}
+
+     Указывай только конкретные нарушения, которые видны в коде — цитируй
+     нарушающую строку и называй конкретное правило. Не сообщай о стиле,
+     не покрытом загруженными правилами. Если фича полностью соответствует
+     правилам, верни пустой массив.`,
+    {
+      label: feature.name,
+      schema: {
+        type: 'object',
+        required: ['violations'],
+        properties: {
+          violations: {
+            type: 'array',
+            items: {
+              type: 'object',
+              required: ['file', 'rule', 'description', 'fix'],
+              properties: {
+                file: { type: 'string' },
+                rule: { type: 'string' },
+                description: { type: 'string' },
+                fix: { type: 'string' },
+              },
+            },
+          },
+        },
+      },
+    },
+  ).then((result) =>
+    result ? result.violations.map((v) => ({ feature: feature.name, ...v })) : [],
+  ),
+)
+
+return perFeature.flat()

package/assets/workflows/redesign-sweep.js

@@ -0,0 +1,152 @@
+export const meta = {
+  name: 'redesign-sweep',
+  description:
+    'Визуальный редизайн экрана или компонента: параллельный UX/архитектурный аудит ' +
+    'текущего UI, design brief, реализация по платформам в изолированном worktree ' +
+    'и проверка сборки. Бизнес-логика не трогается.',
+  whenToUse:
+    'Редизайн UI без изменения поведения — редизайн, обнови дизайн экрана, ' +
+    'поменяй стиль.',
+}
+
+// ── args ────────────────────────────────────────────────────────────────
+//   target : экран или компонент для редизайна (свободный текст, обязателен)
+const A = typeof args === 'string' ? JSON.parse(args) || {} : args || {}
+const TARGET = A.target || A.request || ''
+
+if (!TARGET) {
+  return { status: 'skipped', reason: 'Не передан target — экран или компонент для редизайна.' }
+}
+
+phase('Design')
+const lenses = [
+  {
+    role: 'ux',
+    agentType: 'cuckcoder:ux-reviewer',
+    focus:
+      'текущие визуальные состояния (loading/empty/error/populated), навигация, ' +
+      'accessibility, консистентность с соседними экранами и дизайн-системой',
+  },
+  {
+    role: 'architecture',
+    agentType: 'cuckcoder:architect-auditor',
+    focus:
+      'насколько сильно визуальный слой связан с бизнес-логикой и состоянием, ' +
+      'чтобы визуальное изменение осталось изолированным',
+  },
+]
+
+const audits = await parallel(
+  lenses.map((l) => () =>
+    agent(
+      `Цель редизайна: "${TARGET}". Твоя линза — ${l.role}: ${l.focus}.
+       Проанализируй ТЕКУЩЕЕ состояние этого UI, читая реальный код.
+       Изменится только визуальный слой — бизнес-логика и поведение остаются
+       нетронутыми. Верни наблюдения и конкретные рекомендации.`,
+      {
+        label: `design:${l.role}`,
+        phase: 'Design',
+        agentType: l.agentType,
+        schema: {
+          type: 'object',
+          required: ['observations', 'recommendations'],
+          properties: {
+            observations: { type: 'string' },
+            recommendations: { type: 'array', items: { type: 'string' } },
+          },
+        },
+      },
+    ),
+  ),
+)
+
+const brief = await agent(
+  `Собери design brief для редизайна "${TARGET}".
+   Находки аудита: ${JSON.stringify(audits.filter(Boolean))}.
+   Перечисли компоненты к изменению, визуальные токены (цвет, типографика,
+   spacing, форма), какие платформы затронуты (android-compose и/или
+   ios-swiftui), и явный список того, что должно остаться неизменным
+   (вся бизнес-логика, обработка состояния и поведение). Каждый пункт —
+   атомарное визуальное изменение.`,
+  {
+    label: 'design-brief',
+    phase: 'Design',
+    schema: {
+      type: 'object',
+      required: ['components', 'platforms', 'unchanged'],
+      properties: {
+        components: { type: 'array', items: { type: 'string' } },
+        tokens: { type: 'string' },
+        platforms: {
+          type: 'array',
+          items: { type: 'string', enum: ['android-compose', 'ios-swiftui'] },
+        },
+        unchanged: { type: 'array', items: { type: 'string' } },
+      },
+    },
+  },
+)
+
+phase('Implement')
+const platforms = brief.platforms && brief.platforms.length ? brief.platforms : ['android-compose']
+const targets = platforms.map((p) =>
+  p === 'ios-swiftui'
+    ? { name: p, agentType: 'cuckcoder:swiftui-builder' }
+    : { name: p, agentType: 'cuckcoder:compose-builder' },
+)
+
+const impls = await parallel(
+  targets.map((t) => () =>
+    agent(
+      `Цель редизайна: "${TARGET}". Платформа: ${t.name}.
+       Design brief: ${JSON.stringify(brief)}.
+       Примени ТОЛЬКО визуальные изменения (стили, layout, токены) из этого
+       brief. НЕ трогай бизнес-логику, обработчики событий, состояние или
+       контракты навигации — они перечислены в "unchanged". Используй токены
+       дизайн-системы, а не захардкоженные значения. Верни изменённые файлы
+       и краткое summary.`,
+      {
+        label: `implement:${t.name}`,
+        phase: 'Implement',
+        agentType: t.agentType,
+        isolation: 'worktree',
+        schema: {
+          type: 'object',
+          required: ['changedFiles', 'summary'],
+          properties: {
+            changedFiles: { type: 'array', items: { type: 'string' } },
+            summary: { type: 'string' },
+          },
+        },
+      },
+    ),
+  ),
+)
+
+phase('Validate')
+const changedFiles = impls.filter(Boolean).flatMap((r) => r.changedFiles || [])
+const validation = await agent(
+  `Провалидируй этот редизайн. Изменённые файлы: ${JSON.stringify(changedFiles)}.
+   Собери проект (найди build-инструмент: gradlew, swift build и т.п.) и
+   убедись, что нет ошибок компиляции. Если в окружении доступен инструмент
+   скриншота устройства/эмулятора/симулятора — сделай один скриншот
+   "${TARGET}" после изменения для визуального подтверждения; иначе пропусти
+   этот шаг и напиши об этом. Верни passed (boolean) и details.`,
+  {
+    label: 'validate',
+    phase: 'Validate',
+    agentType: 'cuckcoder:build-engineer',
+    schema: {
+      type: 'object',
+      required: ['passed', 'details'],
+      properties: { passed: { type: 'boolean' }, details: { type: 'string' } },
+    },
+  },
+)
+
+return {
+  status: validation && validation.passed ? 'redesigned' : 'redesign-unverified',
+  brief,
+  changedFiles,
+  validation,
+}