shkola/ЗАДАЧИ/backup/AGENTS.md.opencode.bak-exchange-20261001T230815Z
2026-10-01 23:47:24 +00:00

172 lines
13 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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` и на хостинг напрямую не ходи — обмен только через эти скрипты.