172 lines
13 KiB
Plaintext
172 lines
13 KiB
Plaintext
# Site1 — WordPress project
|
||
|
||
## Project identity
|
||
- Path: /var/www/site1/wordpress
|
||
- Framework: WordPress 6.x
|
||
- Language: PHP 8.x, JavaScript/TypeScript
|
||
- Package manager: Composer (PHP), npm (JS)
|
||
- Database: MySQL (wp-config.php)
|
||
|
||
## Directory structure
|
||
- `wp-admin/` — WordPress admin dashboard (CORE — do not edit)
|
||
- `wp-content/` — Themes, plugins, uploads (editable)
|
||
- `themes/` — Site theme files
|
||
- `plugins/` — WordPress plugins
|
||
- `uploads/` — User uploads (DO NOT delete without confirmation)
|
||
- `wp-includes/` — WordPress core framework (CORE — do not edit)
|
||
- `wp-config.php` — Database and site config (DO NOT modify without explicit confirmation)
|
||
- `.opencode/` — OpenCode configuration (agents, skills, configs)
|
||
|
||
## Autonomy rules
|
||
1. Действуй самостоятельно. Не спрашивай разрешения на:
|
||
- редактирование любых файлов проекта (темы, шаблоны, CSS, JS, PHP, конфиги .opencode/)
|
||
- запись в БД (WP-CLI, Carbon Fields, мета-поля, посты, опции)
|
||
- bash-команды в пределах проекта
|
||
- веб-запросы (fetch, webfetch, curl)
|
||
2. Обязательно спрашивай перед:
|
||
- git push / pull / commit — действия с гитом
|
||
- wp-config.php — конфиг БД
|
||
- правкой конфигов сервера (nginx, apache, php-fpm, systemd, hosts) — системный уровень
|
||
- изменением файлов за пределами `/var/www/site1/wordpress`
|
||
3. NEVER modify `wp-config.php` without explicit confirmation.
|
||
4. NEVER delete files in `uploads/` или `wp-content/uploads/` without explicit confirmation.
|
||
Удаление файлов темы/кода — разрешено (permission: rm ask).
|
||
|
||
## Code standards
|
||
- PHP: PSR-12, type declarations, Composer autoload
|
||
- JS/TS: TypeScript strict, ESM imports, async/await
|
||
- Commits: conventional commits (`feat:`, `fix:`, `chore:`, etc.)
|
||
|
||
## Commands
|
||
- PHP tests: `vendor/bin/phpunit`
|
||
- PHP lint: `vendor/bin/phpstan analyse`
|
||
- JS build: `npm run build`
|
||
- JS test: `npm test`
|
||
- JS lint: `npm run lint`
|
||
|
||
## Project snapshot
|
||
- **MCP:** AgentMemory (канон — см. строку «MCP (canonical)» в шапке `snap-site1-consolidated.md`; НЕ искать через recall — семантический топ-2 не гарантирует последний слепок, возвращал старые 2026-08-04)
|
||
- **Disk:** `snap-site1-consolidated.md` — источник истины
|
||
- **Обновлять:** после каждой крупной правки (страницы/секции/SEO)
|
||
- **Команды:** `/snapshot-update` (обновить: MD5, REMAINING PLAN секциями, MCP-canonical), `/snapshot-load` (вывести только активные задачи секциями)
|
||
- **Содержит:** список страниц, MD5-хэши файлов, SEO health score, REMAINING PLAN секциями по шаблонам + «Закрыто»
|
||
|
||
## Available project skills (load on demand via `/load`)
|
||
- `wp-cli` — WordPress CLI operations (cache flush, plugin mgmt, DB backup)
|
||
- `wordpress-dev` — WordPress development patterns (hooks, REST API, Gutenberg blocks)
|
||
- `php-lint` — PHP code quality (PHPStan, PHPUnit)
|
||
- `wordpress-seo` — SEO-оптимизация: Yoast SEO, schema.org, Core Web Vitals, микроразметка
|
||
- `wordpress-performance` — Оптимизация производительности: кеш, MySQL, ассеты, WebP, CDN
|
||
- `cro-marketing` — Маркетинг и CRO: A/B тесты, UTM, лид-формы, воронки, аналитика
|
||
- `wordpress-security` — Безопасность: харденинг, wp-config, file permissions, security headers
|
||
- `js-build-tooling` — JS/TS сборка: Vite, Webpack, ESLint, TypeScript strict, tree shaking
|
||
- `kill-ai-slop` — Детекция 33 машинных визуальных/копи-тиков (read-only scan.mjs). Запускать ПЕРЕД Taste Skill аудитом как быстрый deterministic pre-check.
|
||
- `wordpress-design` — Дизайн и редизайн: CSS-архитектура, UI-аудит, дизайн-системы, Gutenberg-стилизация
|
||
- `wp-gravity-forms` — Gravity Forms: установка, CLI, API, фиды, нотификации, капча
|
||
- `wp-gravityview` — GravityView: вывод записей GF на фронт, поиск, фильтры
|
||
- `wp-gravity-smtp` — Gravity SMTP: SendGrid, Mailgun, Postmark, SES — конфиг, CVE-2026-4020
|
||
- `wp-pods` — Pods Framework: CPT, таксономии, ACT, кастомные таблицы
|
||
- `wp-bootstrap` — Bootstrap WP-проекта: Playground, Composer, CI, деплой
|
||
- `wp-wpengine` — WP Engine: SSH-деплой, WP-CLI, GitHub Actions, бэкапы
|
||
- `ui-design-system` — design-токены, типографические шкалы, spacing/8pt-сетка, component-архитектура, handoff. ВНИМАНИЕ: усиливает существующую систему `design.txt` (bento), НЕ создаёт вторую параллельную — сгенерированные токены мапить на уже существующие `--*` переменные `main.css`.
|
||
- `a11y-audit` — WCAG 2.2 A/AA: scan (`.css/.html/.js`), контраст, ARIA, keyboard, отчёт, CI. PHP-шаблоны темы НЕ сканирует — для них рендер через Playwright MCP или ручной разбор.
|
||
|
||
## Custom agents
|
||
- `@dev.school` — Primary WordPress agent (auto-activated)
|
||
- `@backend-developer` — Server-side logic, APIs
|
||
- `@frontend-developer` — UI, components, browser APIs
|
||
- `@php-pro` — PHP 8.x best practices
|
||
- `@test-writer` — Test generation
|
||
- `@code-reviewer` — Code review
|
||
- `@git-workflow-manager` — Git workflow
|
||
- `@dependency-manager` — Dependency updates
|
||
|
||
## Design System — bento-типография (основная)
|
||
|
||
Полный справочник дизайн-системы: `/var/www/site1/design.txt` (868 строк, production-ready).
|
||
|
||
**Токены:** генерируются/проверяются скиллом `ui-design-system` (script `design_token_generator.py`), но итог маппится на существующие `--*` переменные `:root` в `main.css`. Вторая параллельная система (второй набор неймспейсов/переменных) — запрещена.
|
||
|
||
Глобальные классы для заголовков секций и подзаголовков, определены в `main.css :root` и в секции 22.
|
||
|
||
**Заголовок секции:** `.bento-h2`
|
||
```
|
||
font-family: var(--font-display);
|
||
font-size: clamp(1.5rem, 2.5vw, 2.25rem);
|
||
font-weight: 700;
|
||
line-height: 1.2;
|
||
margin: 0 0 12px;
|
||
text-wrap: balance;
|
||
```
|
||
|
||
**Описание секции:** `.bento-p`
|
||
```
|
||
font-size: clamp(1rem, 1.2vw, 1.0625rem);
|
||
line-height: 1.7;
|
||
color: var(--color-text-muted);
|
||
margin: 0 0 20px;
|
||
max-width: 70ch;
|
||
text-wrap: pretty;
|
||
```
|
||
|
||
**Контейнер выравнивания:** `.section-header--left`
|
||
- `text-align: left`
|
||
- `.bento-h2, .bento-p`: max-width: none, margin-left: 0, margin-right: auto
|
||
- `.bento-p`: max-width: 65ch
|
||
|
||
Эти классы — **основные** для всех секций на всех страницах (главная, /podgotovka-k-shkole/).
|
||
Ранее главная страница использовала отдельные классы (`.contacts__title`, `.contacts__description`),
|
||
но с 2026-07-23 унифицированы под bento-систему.
|
||
|
||
**Shared компоненты:**
|
||
- `template-parts/teachers-cards.php` — .teachers-cards__* стили в main.css (секция 20)
|
||
- `template-parts/contacts.php` — заголовок/подзаголовок .bento-h2/.bento-p, остальное .contacts__*
|
||
- `template-parts/pksh/contacts.php` — полный bento-стиль (.bento__full, .section-header--left, .bento-h2, .bento-p)
|
||
|
||
**Важно:** `.page-pksh .bento-h2` в `podgotovka-k-shkole.css` дублирует глобальные стили (более специфичный селектор). При редизайне — удалить дубликат из page-specific CSS.
|
||
|
||
## Skill conflicts
|
||
При конфликте между скиллами по одному паттерну — сверяться с `.opencode/skills/anti-slop-precedence.md`.
|
||
Auto-fix kill-ai-slop не запускать без явного разрешения.
|
||
|
||
## Визуальная проверка вёрстки (Playwright MCP) — ИЗБИРАТЕЛЬНО
|
||
|
||
Зрение — дорогой инструмент (токены на скриншот + анализ изображения).
|
||
Включай его ТОЛЬКО когда задача явно про визуальный результат.
|
||
|
||
**ИСПОЛЬЗОВАТЬ зрение, когда задача:**
|
||
- редизайн/рефакторинг страницы или секции (layout, отступы, компоненты)
|
||
- жалоба «вёрстка битая / съехало / наложилось / не отображается»
|
||
- проверка адаптива (мобайл/таблет/десктоп) после CSS-правок
|
||
- применение дизайн-системы к готовой разметке
|
||
- Gutenberg-блоки, где рендер зависит от WP-инъекций стилей
|
||
|
||
**НЕ использовать зрение для:**
|
||
- PHP-логики без визуальных последствий (ACF/Carbon Fields, хуки, кеш, SEO-мета, schema.org, редиректы)
|
||
- текстовых правок (контент, alt-теги) без изменения layout
|
||
- конфигурационных задач (opencode, MCP, .env, деплой-скрипты)
|
||
- точечных CSS-правок одного значения без структурных изменений — достаточно грепа по CSS
|
||
|
||
**Вопрос-фильтр:** «может ли эта правка визуально сломать layout способом, который не виден в коде?» Если нет — не включай зрение.
|
||
|
||
**Протокол при включении зрения (минимизация токенов):**
|
||
1. ОДИН скриншот viewport 1440×900 до правки (не full-page без запроса).
|
||
2. Правки.
|
||
3. ОДИН скриншот после — тот же viewport.
|
||
4. Проверка адаптива — только 375×812 дополнительно, если явно требуется, без промежуточных брейкпоинтов.
|
||
5. Закрывай browser/page сразу после снятия скриншота — не держи сессию между шагами todo.
|
||
6. Не переснимай страницу без изменений — переиспользуй уже полученный в контексте скриншот.
|
||
|
||
Это правило приоритетнее общей инструкции «будь дотошным»: лишний скриншот — трата токенов, а не тщательность.
|
||
|
||
## Обмен задачами (Production ⇄ DEV ⇄ SEO)
|
||
|
||
- Задачи от Production лежат в `<prod>/ЗАДАЧИ/dev-inbox/` (для Щёлково: `/var/www/shl.school/ЗАДАЧИ/dev-inbox/`).
|
||
Список и текст — только своим скриптом: `scripts/dev-tasks.sh list` и `scripts/dev-tasks.sh show <uid>`.
|
||
- Перед началом: `scripts/dev-tasks.sh ack <uid> taken`. После выполнения: `scripts/dev-tasks.sh ack <uid> done --changed "<что и где изменено>"`.
|
||
Невыполнимо/неясно — `scripts/dev-tasks.sh ack <uid> rejected --note "<причина>"`.
|
||
- Файл задачи не удаляй и не правь: статус ведёт исполнитель, журнал пишет скрипт.
|
||
- Если после твоих правок нужна задача Production — поставь её: `scripts/dev-tasks.sh new <prod-site> --key … --type code --verify-after YYYY-MM-DD` (кладёт в `<prod>/ЗАДАЧИ/prod-inbox/`).
|
||
- Поле `origin` (seo|prod|dev|user) и `parent`/`chain` показывают, откуда пришла задача; задачи `origin=seo` пришли по цепочке от SEO-агента.
|
||
- В `/var/www/seo` и на хостинг напрямую не ходи — обмен только через эти скрипты.
|