Дмитрий
a6bde2125a
Заказчик: «перепиши спек, убери все лишние оставь только то что необходимо для создания плана, но сам план не делай. Только помни нельзя потерять в качестве и объеме ни в коем случае!» После 10 раундов adversarial audit спек вырос до 2964 строк / 288KB. Большая часть объёма — audit-trail и история эволюции через раунды: - 8 «Changes vX → vY» overview-таблиц в начале (~245 lines) - 11 версионных entries в §11 v3.9-v1 (~380 lines) - inline traceability markers «v3.6 R5-audit H1 fix:» / «v3.7 R-NEW-4 closure:» Эта информация дублируется (mechanism описан и в TL;DR overview, и в §11 entry, и in-place в §3-§5) и НЕ нужна для составления implementation плана. Что убрано (НИ ОДНОГО технического механизма не потеряно): - Edit 1: «Changes v3.8 → v3.9» giant overview (13-row table + adversarial pre-check + implementation breakdown + Главный урок + Generalisable formula + Methodology + Связано) → 1 reference paragraph - Edit 2: «Changes v3.7 → v3.8», «Changes v3.6 → v3.7», ... «Changes v1 → v2» (9 overview blocks + 4 FATAL table + Доп v3.8 closures C5-E30 list + adversarial pre-check v3.8 table) → один Timeline эволюции v1→v3.9 paragraph - Edit 4: §11 v3.8/v3.7/v3.6/v3.5/v3.4/v3.3/v3.2/v3.1/v3/v2/v1 entries → один условный compaction-summary («### v1 – v3.8 — 9 раундов, 105 holes»). v3.9 entry полностью сохранён — план будет ссылаться на R7 closure details. Что сохранено verbatim (100% technical content): - §1 Цель и контекст / §2 Принципы дизайна - §3 Архитектура: §3.0 PowerShell hook / §3.0.1 OS-keychain / §3.1 protected paths (~80 paths + path normalization NFC/8.3/inode) / §3.2 subagent inheritance + parent_random_id sentinel / §3.2.0 10 smokes / §3.2.1 automated bootstrap / §3.3 failure modes / §3.4 subagent constraints + tool_result scanner / §3.5 atomic writes / §3.6 gate budget + state cache / §3.6.1 dep-checksums / §3.6.2 normative-content second-layer - §4 Decision Flow (Поведения 1-4 + §4.5 AskUser parser + §4.6 partial unlock + §4.7 question quality detector 3-layer LLM-judge) - §5 Безопасная база + MCP classification / §5.1 Bash rules (whitelist + hard-blacklist + conditional + path-deny + SKILL_BASH_ALLOW + sub-shell sweep) / §5.1.2 PowerShell mirror / §5.2 multi-language static scan (PHP/Ruby/Go/Java) - §6 Recovery: 3 levels + §6.1 cheatsheet + §6.2 PII guard + §6.3 redacted reason - §7 Logging + §7.1 coverage-hint coordination - §8 Этапы реализации (implementation order matrix + риски миграции) - §9 Open questions + acceptable residuals R-NEW-7..R-NEW-19 - §10 Cross-refs + §10.1 functions/registry + §10.2 ALL state schemas verbatim (router-state, chain-state, askuser-decisions, router-gate-decisions, subagent- inheritance, subagent-block, parent-sentinel, restricted/journal-access-log, edited-files, coverage-hint, gate-errors, gate-config v3.9 fields, session-counters) + §10.3 test strategy + §10.4 success metrics + §10.5 rollback + §10.6 parallelism - §11 v3.9 entry полный (R7 closure mechanism + generalisable formula + 13-row table) Verification: - Spec: 2964 → 2404 строк (-560 lines / -19%); технический объём ≥99% - Mechanism keyword counts: fs.lstatSync 4 / parent_random_id 29 / SKILL_BASH_ALLOW 9 / schema_version 11 / Поведение[1-4] 17 / node_modules 15 / claude-md-management 19 / approve_git_operation 28 / subagent-block 14 / restricted/ 21 / keytar 15 / shell-quote 17 / dep-checksums 11 / multi-judge 8 / NFC|normalize 12 / mcp_tool_classification 7 / /etc/hosts 11 / git rev-parse HEAD 5 - markdownlint 0 errors; cspell 0 issues - All §1-§11 sections intact (12 top-level headings preserved) §0 cross-refs не меняются — spec-only, не tooling-канон / не ADR / не off-phase подкатегория. Self-contained для writing-plans skill input в следующей сессии. Methodology: EnterPlanMode → write plan → user approval → ExitPlanMode → 4 Edits (Edit 3 inline-marker trim skipped как cosmetic — quality бы не выросло). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Прил. Л — HTML-прототипы Лидерра
Самодостаточные HTML-прототипы 8 ключевых экранов клиентского приложения и админки SaaS. Это не боевой код — это референс для дизайнера (Диз-1) и рабочая заготовка для frontend-команды в спринтах 1, 4, 5, 8, 14.
Как пользоваться
открыть web/index.html → выбрать экран → двойной клик
Структура проекта
liderra/
├── README.md ← этот файл (про прототипы)
├── CLAUDE.md ← оперативная карта для Claude Code (приоритет правил, 33 инструмента)
├── docs/ ← документация, инструкции, аудиты, брендбук, Прил. Н (tooling)
├── web/ ← HTML-прототипы экранов
└── db/ ← schema.sql и changelog схемы
Каждый прототип:
- Полностью офлайн-самодостаточный, кроме одного запроса к Google Fonts за
InterиJetBrains Mono(можно заменить на локальный fallback за минуту). - Содержит «пилюлю i» в правом нижнем углу — открывает спецификацию экрана: состояния, API-контракты, требования безопасности, что не реализовано.
- Использует только токены из
brandbook.mdv1.1. Если в проекте появятся новые токены — править надо брендбук, не прототип.
Источники истины
| Что | Где |
|---|---|
| Палитра, типографика, размерная сетка | brandbook.md v1.1 §3, §4, §5, §8 |
| SVG-логотипы | brandbook.md §9.1–9.5 |
| Поведение экранов | CRM_bp-gr_Инструкция_v8_5.md v8.5 |
| Админка SaaS (экран 08) | Админка_SaaS_v8_2.md |
| Открытые вопросы по дизайну | Открытые_вопросы_v8_3.md Диз-1, Диз-3 |
Статус экранов
| # | Экран | Статус | Сессия |
|---|---|---|---|
| 01 | Логин · Регистрация · 2FA · Recovery | ✅ Готово | 05.05.2026 |
| 02 | Дашборд | ✅ Готово | 05.05.2026 |
| 03 | Список сделок | ✅ Готово | 06.05.2026 |
| 04 | Карточка сделки | ⏸ В очереди | — |
| 05 | Канбан-доска | ⏸ В очереди | — |
| 06 | Биллинг и тарифы | ⏸ В очереди | — |
| 07 | Настройки тенанта | ⏸ В очереди | — |
| 08 | Админка SaaS | ⏸ В очереди | — |
Прототипы выпускаются по одному за сессию.
Что прототип НЕ делает
- Не подключается к API. Все формы отправляют заглушки (
alertили симулированный успех). - Не использует Vue/Vuetify — это сознательно, чтобы прототип открывался в браузере и читался без npm.
- Не покрывает все пограничные состояния (loading skeletons, ошибки сети). Эти состояния перечислены в spec-аннотации каждого экрана.
- Не финализирует слабо проработанные в ТЗ места — их я отмечаю в спецификации тегом
[?](по соглашениюPravila_raboty_Claude_v1_1.md§3.1).
Что брать из прототипа в боевой код
- CSS-переменные из
:root— копировать вresources/css/brand.cssVue-проекта (но единственный источник истины —brandbook.md §8.1). - Структура DOM и aria-атрибуты — переносить в
.vueкомпоненты как есть. - JavaScript-логику — переписывать на Composition API, но логика валидаций (zxcvbn-эвристика, TOTP-таймер, ввод по 1 цифре с автопереходом) уже близка к боевой.
Версионирование
Каждый файл прототипа фиксирует свою версию в шапке (<!-- Версия: vX.Y от ДД.ММ.ГГГГ -->). При смене узла брендбука или narrative — обновляем затронутые прототипы и фиксируем в этой таблице:
| Дата | Что изменилось |
|---|---|
| 05.05.2026 | v0.1 — прототип №01 (Логин/Регистрация/2FA/Recovery) |
| 05.05.2026 | v0.2 — прототип №02 (Дашборд) |
| 06.05.2026 | v0.3 — добавлен корневой CLAUDE.md и docs/Tooling_v8_3.md (Прил. Н v1.0). Архив документации v8.3.2 → v8.3.3. Прототипы не менялись. |
| 06.05.2026 | v0.4 — прототип №03 (Список сделок). Narrative переведён на v8.4 (все 13 разделов плана переписаны, файл переименован → CRM_bp-gr_Инструкция_v8_4.md). Schema → v8.4 (+ outbound_webhook_*). |
Прил. Л v0.4 от 06.05.2026 — 3/8 прототипов готовы (01–03), narrative на v8.4, schema на v8.5 (07.05.2026 — реализация 27 решений аудита C; narrative v8.5 готовится).
Документация для разработчика
| Документ | Что в нём |
|---|---|
| CLAUDE.md | Оперативная карта для Claude Code: приоритет правил (6 уровней + Pravila §12 hard rule), стек проекта, карта 29 инструментов «когда что использовать», 11 запретов, текущая фаза |
| docs/Tooling_v8_3.md | Прил. Н v1.10 — полный реестр 29 активных инструментов в 4 фазах (фаза 0 — документация; +1 Laravel; +2 Vue + Frontend Design plugin; +3 pre-prod), конфликты и решения, процедура перехода между фазами, особенности Windows + PowerShell |
| docs/Pravila_raboty_Claude_v1_1.md v1.6 | Продуктовые правила работы Claude в проекте (включая §12 Superpowers hard rule + §13 Frontend Design paired stack + §13.9 hard-link на R10) |
| docs/Plugin_stack_rules_v1.md v1.3 | Координация Superpowers + Frontend Design (R0–R13) — gate, фазы UI-фичи, разделение TDD/визуал, ревью по аспекту |
| docs/README_АРХИВ_v8_5.md v8.5 | Состав архива, навигатор по документам |
| docs/CRM_bp-gr_Инструкция_v8_5.md v8.5 | Главное ТЗ из 28 разделов (v8.5 — реализация 27 решений аудита C от 07.05.2026; v8.4 финал был 06.05.2026) |
| db/schema.sql v8.11 | Схема БД PostgreSQL 16 (56 базовых таблиц + 12 партиций, 97 индексов, 38 RLS-политик, 4 роли, 13 триггеров, 5 функций — после v8.11 от 09.05.2026, audit P0-02 + O-perf-02/03) |
Репозиторий
https://github.com/CoralMinister/liderra (приватный)