# NOISY Lab: кратко описание за AI асистент

Копирай този файл в своя AI асистент (Claude, ChatGPT, Codex), за да му дадеш контекста на NOISY Lab. Пълният документ е `docs/PM-TECHNICAL.md` в хранилището на проекта.

## Какво е

NOISY Lab е начинът, по който екипът на NOISY (стрийминг продукт на MediaHub) прави дизайн. Дизайнерите работят с AI агент (Claude Code или Codex), който пише истински код на прототипа. Всеки вариант е жив екран в браузъра, не картинка. Всичко е в едно GitHub хранилище.

## Защо

Досега дизайнът се правеше във Figma. Проблемите (срещата от 30.10.2026):
- прототипирането е бавно;
- резултатите с AI не са консистентни: всеки прави HTML поотделно, без обща дизайн система и контекст;
- DEV трудно разбира поведението и анимациите от Figma; в код се разбират по-лесно;
- DEV не знае точно какво да направи, защото получава картина без състояния и случаи;
- не се знае кое е последното и какво е решено;
- спецификациите пропускат случаи;
- дизайните се правят в различни периоди, поотделно, и не се вижда как изглежда продуктът като цяло.

Условия: процесът трябва да е лесен, да не зависи от модела (Claude или Codex) и да има помощ при старта.

## Как работи

1. Дизайнерът казва на агента „нова задача <име>“. Агентът прави клон `task/<човек>/<задача>`, бележки (цел, направено, остава) и чернова в GitHub.
2. Агентът прави варианти в `prototype/` (Next.js, по зони Discover, Theater, Arena, Newsroom, Showtime) с превключвател `?v=a`, `?v=b`, само с токените и компонентите от `design-system/`.
3. „Покажи ми“: агентът записва версия (снимки 390 и 1440 px, точен commit, бележка) и я слага на Стената.
4. Стената (https://noisy-stena.pages.dev) показва всички версии на всеки екран със статус: чернова, за одобрение, одобрено, в разработка, готово, върнато.
5. PM избира на Стената, дизайнерът казва „готово“, PM одобрява pull request-а в GitHub и той се слива в `main`.
6. PM праща на DEV пакет от точния одобрен commit: снимки, спецификация със случаите, кодът на прототипа. Въпрос от DEV връща версията като „върнато“.

Докато се работи в задача, работата се записва и изпраща в GitHub след всеки отговор на агента. Колега може да поеме задача с „продължи задачата <име>“.

## Не зависи от един AI

Правилата са в `AGENTS.md` (общ формат за Codex, Claude, Cursor, Copilot, Gemini), уменията в `.agents/skills/`, паметта (профили, вкус, бележки, решения) във файлове в GitHub, командите са Node.js скриптове. Автоматичните стъпки имат настройка и за Claude, и за Codex. Минаването към Codex или друг AI не губи работа; само панелът със Стената е специфичен за приложението Claude (в Codex Стената е в браузъра).

## Режими на данните в прототипа

`?data=demo` (подредено демо), `today` (програма спрямо часовника), `future` (бъдещ момент), `edge` (липсващи данни, дълги текстове, забавяне).

## Правила

- Всичко е само с фирмени акаунти на фирмения имейл (`@mediahub.eu`): GitHub, Claude, Figma. Стената и линковете за преглед ще се затворят с вход с фирмен имейл (Cloudflare Access); поверителни данни не се слагат в прототипа.
- Цветове и шрифтове само от `design-system/tokens.css`; компонентите от `design-system/COMPONENTS.md` 1:1. Проверка при commit спира нарушенията.
- `DESIGN.md` описва визията и забраните срещу „AI вида“.
- Основата (`AGENTS.md`, `scripts/`, `.github/`, `PRODUCT.md`) се пипа само с одобрение от PM.
- `DESIGN.md` и `design-system/` се приемат от PM или от двама дизайнери, различни от автора.
- Хората и одобряващите са в `.github/team.json`; одобрение се брои само от GitHub акаунт, след последната промяна.
- Снимки от интернет са позволени в прототипа със запис в `SOURCES.md`; към DEV отива само дизайн с компонентите на NOISY.
- Еталон на екран е последният одобрен от PM дизайн на същия екран.

## Какво не е

Не е продуктовият код и не е свързан с живи данни. Не е инструмент за управление на проекти. Figma остава за полиш и дизайн системата.

## Важни файлове

`AGENTS.md` (правилата за агента), `docs/GUIDE.md` (как се работи), `docs/PM-TECHNICAL.md` (пълното описание), `design-system/`, `DESIGN.md`, `PRODUCT.md`, `specs/<зона>/<екран>.md`, `designers/<име>/` (профил и вкус), `tasks/<задача>/<човек>.md` (бележки).