cosy — AGENTS.md

Что за проект

cosy — сайт-визитка продукта в фазе исследования: безопасная ИИ-операционная система для семейного планшета, где ребёнок — оператор ИИ, а не потребитель бесконечной ленты. Сайт мульти-страничный (продуктовый нарратив, открытый ресерч, мета-раздел про то, как всё это сделано) и целиком собирается и поддерживается ИИ-агентами под присмотром команды Mars IT School — от исследования рынка до вёрстки и публикации.

Стек и деплой

Сайт — статика: чистый HTML/CSS/JS без сборщика, один общий дизайн-хребет assets/cosy.css и общий скрипт assets/cosy.js на всех страницах. Хостится на MarshHub — внутренней платформе Mars для статических сайтов и мини-приложений.

Параметр	Значение
Хостинг	MarshHub (статика)
Команда деплоя	`marshub deploy --name aifirstos`
Домен	aifirstos.marshub.uz
Авторизация правок	только с явного разрешения человека

Карта «где что лежит»

Плоская структура внутри проекта. Ниже — только имена папок, без путей к конкретной машине.

Папка	Что внутри
`research/`	5 параллельных ИИ-ресерчей: партнёр [партнёр], модель app/skill/agent, концепт и рынок, каталог = MarshHub, дизайн-система. Источник фактов и цифр для всего сайта.
`site/`	Готовые HTML-страницы сайта + `assets/` (cosy.css, cosy.js) — то, что реально деплоится.
`docs/`	Снапшоты и служебные материалы — например, снимок предыдущей версии сайта до ребрендинга.
`BRIEF.md`	Единый источник истины: структура сайта, тон, дизайн-контракт, guardrails, копирайт-якоря. Каждый агент сверяется с ним перед версткой.

Принципы работы агента

Тон — тёплый, умный, спокойный, семейный, но premium: без мультяшности и без корпоративного холода. Дизайн-дисциплина обязательна — один дизайн-хребет на весь сайт, никакой самодеятельности с цветами, радиусами или шрифтами вне утверждённой системы.

Честность — часть бренда, а не формальность. Проект сейчас в фазе исследования (2025–2026), и агенты обязаны это отражать буквально:

Не обещать больше, чем есть — никаких «купить», «доступно», «работает» там, где на деле «проектируем», «исследуем», «гипотеза».
Где вывод — гипотеза, а не факт, так и называть это гипотезой.
Партнёрские направления и внешние спецификации подавать с пометкой, что они всё ещё проверяются, а не как готовые договорённости.
Даты и таймлайн держать в рамках канона: 2025–2026 — фаза ресерча, дальнейшие годы — план, не обязательство.

Границы

✅

Всегда — сверяться с BRIEF.md перед версткой; использовать только дизайн-токены и классы из общего cosy.css; писать честный, проверяемый копирайт; помечать гипотезы гипотезами; обобщать внутренние источники без раскрытия приватных деталей.

⚠️

Спросить — прежде чем менять структуру сайтмапа или общий шаблон шапки/подвала; прежде чем публиковать новую страницу или деплоить на прод; при любом расхождении между ресерчем и брифом.

🚫

Никогда — публиковать секреты, токены, пароли или приватные пути; обещать несуществующий функционал или сроки как факт; деплоить без разрешения человека; указывать реальные внутренние адреса, имена машин или серверов на публичных страницах.

Это публичная выжимка внутреннего AGENTS.md проекта. Полная версия с операционными деталями команды остаётся внутренней.

Как ИИ-агенты работают над cosy

Что за проект

Стек и деплой

Карта «где что лежит»

Принципы работы агента

Границы