konveyer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pavel (html5-studio.ru)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Makefile

@@ -0,0 +1,26 @@
+# ===== Конвейер тасков — базовые команды =====
+# make task T=KAN-12    взять задачу: ветка + worktree + Claude
+# make pr               открыть Pull Request (для ревью Copilot)
+# make done T=KAN-12    влить ветку и прибрать за собой
+
+BASE ?= main
+
+task:
+	@test -n "$(T)" || { echo "Так: make task T=KAN-12"; exit 1; }
+	git fetch origin $(BASE)
+	git worktree add -b feature/$(T) ../wt-$(T) origin/$(BASE)
+	@cp .env ../wt-$(T)/.env 2>/dev/null || true
+	@echo "→ feature/$(T) готова в ../wt-$(T)"
+	cd ../wt-$(T) && claude "Возьми в работу задачу $(T). Работай по регламенту из CLAUDE.md: статусы в Jira, код, AI-ревью до Done."
+
+pr:
+	git push -u origin HEAD
+	gh pr create --fill
+
+done:
+	@test -n "$(T)" || { echo "Так: make done T=KAN-12"; exit 1; }
+	git checkout $(BASE) && git pull origin $(BASE)
+	git merge --no-ff feature/$(T) -m "merge: $(T)"
+	git push origin $(BASE)
+	git worktree remove ../wt-$(T) --force
+	git branch -d feature/$(T)

package/README.md

@@ -0,0 +1,51 @@
+# Конвейер тасков — бесплатная часть
+
+ИИ сам берёт задачи из Jira: читает описание, пишет код, проходит AI-ревью и закрывает тикет с комментарием. Это открытая часть курса — промпты, которые настраиваются за один вечер. Отдельный API-ключ не нужен: всё работает на вашей подписке Claude Code.
+
+**Полный курс с пошаговой инструкцией:** [html5-studio.ru/kurs](https://html5-studio.ru/kurs)
+
+## Установка
+
+```bash
+npx konveyer          # что это, что уже настроено и что делать дальше
+npx konveyer init     # разложить промпты и Makefile в свой проект
+npx konveyer prompt 1 # напечатать промпт (| pbcopy — сразу в буфер)
+```
+
+Глобально ничего не ставится, зависимостей у пакета нет — `npx` отрабатывает мгновенно.
+
+## Что внутри
+
+| Файл | Что делает |
+|---|---|
+| [prompts/prompt-1-razvedka.md](prompts/prompt-1-razvedka.md) | Учит ИИ вашей Jira-доске: статусы, переходы, задачи. Только чтение, ничего не меняет |
+| [prompts/prompt-2-reglament.md](prompts/prompt-2-reglament.md) | Записывает регламент работы с Jira в CLAUDE.md — навык остаётся в каждой новой сессии |
+| [prompts/prompt-3-rabota.md](prompts/prompt-3-rabota.md) | Рабочий режим: «возьми в работу KAN-12» — и всё |
+| [prompts/prompt-4-reviewer.md](prompts/prompt-4-reviewer.md) | AI-ревьюер: отдельный агент проверяет каждую задачу перед Done по чек-листу с приоритетами P0–P3 |
+
+## Быстрый старт
+
+1. Jira Cloud (бесплатный план) + API-токен: id.atlassian.com → Security → Create API token
+2. `.env` в корне проекта: `JIRA_BASE_URL`, `JIRA_EMAIL`, `JIRA_API_TOKEN`, `JIRA_PROJECT` (и `.env` — в `.gitignore`!)
+3. `npm install -g @anthropic-ai/claude-code`, в папке проекта — `claude`, модель Fable
+4. Промпты 1 → 2 → 3 по очереди. Промпт 4 — когда захотите ревью
+
+Подробная инструкция с картинками — [в бесплатном курсе](https://html5-studio.ru/kurs).
+
+> **Нет своего проекта под рукой?** Возьмите готовый шаблон
+> [ressh/konveyer-starter](https://github.com/ressh/konveyer-starter) (кнопка
+> **«Use this template»**) — простое приложение и вся обвязка уже внутри
+> (`Makefile`, `CLAUDE.md`, ревьюер). Останется вписать `.env` и запустить `make task`.
+
+## Уровни выше
+
+Этот репозиторий — уровень 1: одна задача за раз. Полный конвейер, на котором мы разрабатываем [CHATBOSS.PRO](https://chatboss.pro), — это эпики и волны, git worktree на каждую задачу, два AI-ревьюера (код + архитектура) и staged deploy:
+
+- **Мануал «AI-конвейер своими руками»** — [предзаказ 2 990 ₽](https://html5-studio.ru/manual)
+- **Настройка под ключ** — [форматы и цены](https://html5-studio.ru/uslugi/ai-konveyer-zadach)
+
+## Обновления
+
+Репозиторий пополняется по мере выхода глав мануала. Нажмите **Watch** (или ⭐), чтобы получить весточку.
+
+Вопросы: Telegram [@paul_cop](https://t.me/paul_cop) · [html5-studio.ru](https://html5-studio.ru)

package/bin/cli.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+// =============================================================
+// konveyer — бесплатная часть конвейера тасков.
+//
+// Без аргументов: экран онбординга — что уже есть в системе, какие промпты
+// и в каком порядке скармливать Claude Code.
+//   konveyer init        разложить промпты и Makefile в текущий проект
+//   konveyer prompt 1    напечатать промпт (удобно: konveyer prompt 1 | pbcopy)
+//
+// Зависимостей нет намеренно: npx должен отрабатывать мгновенно, а не тянуть
+// половину реестра ради четырёх markdown-файлов.
+// =============================================================
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+const ROOT = path.join(__dirname, '..');
+const pkg = require(path.join(ROOT, 'package.json'));
+
+// ── оформление ───────────────────────────────────────────────
+// Цвет гасим, когда вывод уходит не в терминал (в пайп, в файл, в CI):
+// иначе ESC-последовательности попадут в текст, который человек копирует.
+const plain = !process.stdout.isTTY || process.env.NO_COLOR;
+const c = (code, s) => (plain ? s : `\x1b[${code}m${s}\x1b[0m`);
+const bold = (s) => c('1', s);
+const dim = (s) => c('2', s);
+const accent = (s) => c('36', s);
+const ok = (s) => c('32', s);
+const warn = (s) => c('33', s);
+
+const PROMPTS = [
+  { n: 1, file: 'prompt-1-razvedka.md', title: 'научите ИИ вашей Jira', note: 'создаёт .env, проверяет связь, разведывает доску' },
+  { n: 2, file: 'prompt-2-reglament.md', title: 'закрепите навык в CLAUDE.md', note: 'регламент действует в каждой новой сессии' },
+  { n: 3, file: 'prompt-3-rabota.md', title: 'рабочий режим', note: '«возьми в работу KAN-12» — и всё' },
+  { n: 4, file: 'prompt-4-reviewer.md', title: 'AI-ревьюер', note: 'второй агент проверяет задачу перед Done' },
+];
+
+// ── проверки окружения ───────────────────────────────────────
+
+/** Есть ли команда в PATH. Тихо: отсутствие — обычное дело, не ошибка. */
+function has(cmd) {
+  try {
+    execFileSync(process.platform === 'win32' ? 'where' : 'which', [cmd], { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function checks() {
+  const node = process.versions.node;
+  const nodeOk = Number(node.split('.')[0]) >= 18;
+  return [
+    { label: `Node ${node}`, ok: nodeOk, fix: 'нужен Node 18+: nodejs.org или nvm' },
+    { label: 'git', ok: has('git'), fix: 'поставьте git: git-scm.com' },
+    { label: 'Claude Code', ok: has('claude'), fix: 'npm install -g @anthropic-ai/claude-code' },
+    { label: '.env с доступом к Jira', ok: fs.existsSync(path.join(process.cwd(), '.env')), fix: 'создаст промпт №1 — это нормально на старте' },
+  ];
+}
+
+// ── экраны ───────────────────────────────────────────────────
+
+function promo() {
+  console.log(dim('─'.repeat(62)));
+  console.log(`${bold('Дальше — «Конвейер тасков»')}: эпики и волны задач, отдельный`);
+  console.log('git worktree на каждую задачу, два AI-ревьюера (код и архитектура),');
+  console.log('приёмка волн и деплой. Несколько агентов работают параллельно и');
+  console.log('не мешают друг другу.');
+  console.log(`   Ранний доступ: ${accent('https://html5-studio.ru/manual')}`);
+  console.log(`   Вопросы автору: ${accent('https://t.me/paul_cop')}`);
+}
+
+function welcome() {
+  console.log('');
+  console.log(bold('  🛠  Конвейер тасков — бесплатная часть'));
+  console.log(dim('  ИИ берёт тикет из Jira, пишет код, проходит ревью и закрывает задачу.'));
+  console.log('');
+
+  console.log(bold('  Что у вас есть:'));
+  for (const ch of checks()) {
+    console.log(ch.ok ? `   ${ok('✓')} ${ch.label}` : `   ${warn('•')} ${ch.label} ${dim('— ' + ch.fix)}`);
+  }
+  console.log('');
+
+  console.log(bold('  Промпты — скармливайте по порядку:'));
+  for (const p of PROMPTS) {
+    console.log(`   ${accent(String(p.n))}. ${p.title} ${dim('— ' + p.note)}`);
+  }
+  console.log('');
+
+  console.log(bold('  Как пользоваться:'));
+  console.log(`   ${accent('npx konveyer init')}       разложить промпты и Makefile в этот проект`);
+  console.log(`   ${accent('npx konveyer prompt 1')}   напечатать промпт ${dim('(| pbcopy — сразу в буфер)')}`);
+  console.log('');
+  console.log(dim('  Инструкция с картинками: https://html5-studio.ru/kurs'));
+  console.log('');
+  promo();
+  console.log('');
+}
+
+/** Копирование без перезаписи: чужой файл в проекте человека — не наша вещь. */
+function copyIfAbsent(from, to, label) {
+  if (fs.existsSync(to)) {
+    console.log(`   ${dim('•')} ${label} ${dim('— уже есть, не трогаю')}`);
+    return false;
+  }
+  fs.cpSync(from, to, { recursive: true });
+  console.log(`   ${ok('✓')} ${label}`);
+  return true;
+}
+
+function init() {
+  const cwd = process.cwd();
+  console.log('');
+  console.log(bold(`  Раскладываю конвейер в ${cwd}`));
+  console.log('');
+
+  copyIfAbsent(path.join(ROOT, 'prompts'), path.join(cwd, 'prompts'), 'prompts/ — четыре промпта');
+  copyIfAbsent(path.join(ROOT, 'Makefile'), path.join(cwd, 'Makefile'), 'Makefile — make task / pr / done');
+
+  const envExample = path.join(cwd, '.env.example');
+  if (!fs.existsSync(envExample)) {
+    fs.writeFileSync(envExample, [
+      'JIRA_BASE_URL=https://your-company.atlassian.net',
+      'JIRA_EMAIL=you@example.com',
+      'JIRA_API_TOKEN=',
+      'JIRA_PROJECT=KAN',
+      '',
+    ].join('\n'));
+    console.log(`   ${ok('✓')} .env.example — четыре поля для Jira`);
+  } else {
+    console.log(`   ${dim('•')} .env.example ${dim('— уже есть, не трогаю')}`);
+  }
+
+  console.log('');
+  console.log(bold('  Дальше:'));
+  console.log(`   1. Токен Jira: ${accent('https://id.atlassian.com')} → Security → Create API token`);
+  console.log(`   2. ${accent('npx konveyer prompt 1')} → вставьте в Claude Code`);
+  console.log('   3. Промпты 2 и 3 следом. Промпт 4 — когда захотите ревью');
+  console.log('');
+  console.log(warn('   Не забудьте: .env — в .gitignore. В нём токен доступа к вашей Jira.'));
+  console.log('');
+}
+
+function printPrompt(arg) {
+  const found = PROMPTS.find((p) => String(p.n) === String(arg));
+  if (!found) {
+    console.error(`Промпт «${arg}» не найден. Есть: 1, 2, 3, 4.`);
+    process.exit(1);
+  }
+  // Печатаем как есть, без рамок и цвета: этот вывод человек копирует в чат.
+  process.stdout.write(fs.readFileSync(path.join(ROOT, 'prompts', found.file), 'utf8'));
+}
+
+function help() {
+  console.log(`
+  konveyer — бесплатная часть конвейера тасков
+
+  ${accent('npx konveyer')}             экран онбординга: что есть, что дальше
+  ${accent('npx konveyer init')}        разложить промпты и Makefile в текущий проект
+  ${accent('npx konveyer prompt N')}    напечатать промпт N (1–4)
+  ${accent('npx konveyer --version')}   версия пакета
+
+  Документация: https://html5-studio.ru/kurs
+`);
+}
+
+// ── разбор аргументов ────────────────────────────────────────
+
+const [cmd, arg] = process.argv.slice(2);
+
+switch (cmd) {
+  case undefined:
+    welcome();
+    break;
+  case 'init':
+    init();
+    break;
+  case 'prompt':
+    printPrompt(arg);
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    help();
+    break;
+  case 'version':
+  case '--version':
+  case '-v':
+    console.log(pkg.version);
+    break;
+  default:
+    console.error(`Неизвестная команда «${cmd}». Подсказка: npx konveyer help`);
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "konveyer",
+  "version": "0.1.0",
+  "description": "AI-конвейер задач: ИИ берёт тикет из Jira, пишет код, проходит AI-ревью и закрывает задачу. Промпты для Claude Code.",
+  "keywords": [
+    "jira",
+    "claude",
+    "claude-code",
+    "ai-agent",
+    "ai-review",
+    "automation",
+    "workflow",
+    "konveyer"
+  ],
+  "homepage": "https://html5-studio.ru/kurs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ressh/konveyer-taskov.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ressh/konveyer-taskov/issues"
+  },
+  "author": "html5-studio (https://html5-studio.ru)",
+  "license": "MIT",
+  "bin": {
+    "konveyer": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "prompts/",
+    "Makefile",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}

package/prompts/prompt-1-razvedka.md

@@ -0,0 +1,13 @@
+# Промпт №1 — научите ИИ вашей Jira
+
+ИИ создаст `.env` (вы впишете четыре значения), проверит связь и разведает доску — статусы, переходы, задачи. В Jira ничего не меняется.
+
+Проверка: показал имя вашего аккаунта — связка работает. Ошибка 401 — перепроверьте email и токен в `.env`.
+
+```
+Настраиваем работу с моей Jira Cloud. Доступы держим в .env в корне проекта: JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT. Токен нельзя выводить в чат, логи или код и нельзя просить меня вставлять его в сообщения — значения я впишу в файл сам.
+
+Шаг 1. Если .env нет — создай его с этими четырьмя заглушками, добавь .env в .gitignore и объясни, где взять каждое значение (адрес Jira, почта аккаунта, API-токен с id.atlassian.com, ключ проекта). Остановись и жди моего «готово».
+
+Шаг 2. Когда скажу «готово» — проверь связь и разведай доску, ничего в ней не меняя: чьим аккаунтом подключились, какие типы задач и статусы на доске, какие переходы между статусами доступны, какие последние задачи. Как обращаться к Jira — реши сам под мой проект. В конце — короткая сводка и что лежит в To Do.
+```

package/prompts/prompt-2-reglament.md

@@ -0,0 +1,22 @@
+# Промпт №2 — закрепите навык в системных настройках
+
+ИИ запишет регламент работы в `CLAUDE.md` — память Claude Code. Навык будет действовать в каждой новой сессии.
+
+Проверка: в корне появился (или дополнился) `CLAUDE.md` с разделом «Работа с Jira», а `.env` числится в `.gitignore`.
+
+```
+Связка с Jira работает — закрепи навык в CLAUDE.md, чтобы он действовал в каждой новой сессии. Создай или дополни раздел:
+
+## Работа с Jira
+- Доступы — в .env (JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT). Токен не выводить в чат, логи и код. .env должен быть в .gitignore.
+- Команда «возьми в работу {ключ}» — это полный цикл задачи:
+  1. Прочитать задачу. Нет критерия приёмки — сформулировать и показать мне до старта.
+  2. Перевести в работу на доске.
+  3. Сделать в коде проекта.
+  4. Отдать отдельному субагенту-ревьюеру: приёмка, ошибки, крайние случаи, стиль. Замечания исправить до закрытия.
+  5. Закрыть задачу (через Review/Testing, если такие колонки есть) с комментарием: что сделано, какие файлы затронуты.
+- Крупную задачу — сначала предложить разбить на подзадачи и дождаться моего «ок».
+- «Стоп» — аккуратно завершить шаг и записать в Jira честный статус.
+
+Запиши, покажи итоговый CLAUDE.md и подтверди готовность.
+```

package/prompts/prompt-3-rabota.md

@@ -0,0 +1,9 @@
+# Промпт №3 — рабочий режим: задача по номеру
+
+Это всё. Теперь ваш ежедневный «промпт» — одна строка с номером тикета. Остальное ИИ делает по регламенту из `CLAUDE.md`.
+
+Замените KAN-12 на ключ своей задачи. Работает и в новых сессиях: регламент уже в `CLAUDE.md`.
+
+```
+Возьми в работу задачу KAN-12.
+```

package/prompts/prompt-4-reviewer.md

@@ -0,0 +1,30 @@
+# Промпт №4 — AI-ревьюер: второй взгляд на каждую задачу
+
+Автор кода — плохой судья своему коду, даже если автор ИИ. Отдельный агент со свежим контекстом ловит то, что замылилось: несоответствие приёмке, крайние случаи, секреты в коде. На CHATBOSS.PRO ревью проходит каждая задача.
+
+После промпта в `CLAUDE.md` появится раздел «AI-ревью», и каждая задача перед Done проходит проверку с приоритетами P0–P3.
+
+```
+Дополни CLAUDE.md разделом «AI-ревью» и работай по нему при закрытии каждой задачи:
+
+## AI-ревью
+- Перед Done запускай отдельного субагента-ревьюера со свежим контекстом. Дай ему критерий приёмки и diff изменений.
+- Проверяй: соответствие приёмке; ошибки и крайние случаи (пустые данные, null, гонки); безопасность (секреты в коде, инъекции, открытые эндпоинты); читаемость и стиль проекта.
+- Каждое замечание — с приоритетом: P0 блокирует Done, P1 исправить сейчас, P2 отложить (завести задачу), P3 вкусовщина.
+- P0/P1 чини сразу и прогоняй ревью повторно. Закрывать задачу можно только с пустым P0/P1.
+- Итог ревью — комментарием к задаче: сколько замечаний и что исправлено.
+
+Запиши раздел, покажи CLAUDE.md и подтверди готовность.
+```
+
+## Лайфхак: бесплатный ревьюер из GitHub Copilot
+
+Если код на GitHub — второй взгляд можно получить бесплатно:
+
+1. Запушьте ветку, откройте Pull Request.
+2. В Reviewers выберите **Copilot** («Request review from Copilot»).
+3. Через пару минут он оставит построчные комментарии.
+4. Отдайте их исполнителю: «исправь замечания из ревью PR».
+5. В настройках репозитория можно включить авто-ревью каждого PR.
+
+Под капотом — GPT-4.1: уровень кода (типы, крайние случаи, забытые проверки) ловит стабильно, архитектуру хуже — для неё в полном конвейере второй ревьюер. Тариф Copilot Free работает без карты.