Skip to content

AGENTS.md

Latest commit

 

History

History
108 lines (91 loc) · 6.3 KB

AGENTS.md

File metadata and controls

108 lines (91 loc) · 6.3 KB

AGENTS.md - Основные правила работы с проектом

Обзор проекта

Этот проект содержит веб-приложения: инструменты для оценки задач, музыкальный тренажёр и браузерные игры.

  • how-many-sp - калькулятор сторипоинтов на основе трёх критериев
  • triangular-estimation - оценка по трём точкам (метод PERT)
  • gamma-trainer - тренажёр по ладовым гаммам и ступеням
  • babylon-tower - 3D-головоломка «Pentagonal Prism Slider» на Three.js
  • my-valentine - арканоид-игра с блоками в форме сердца
  • tic-tac-toe - Swap-Tac-Toe: крестики-нолики с механикой swap и ИИ
  • the-maze - Dual Grid Puzzle: головоломка с одновременным движением двух объектов

Структура файлов

thisman.github.io/
├── index.html                 # Главная страница
├── index.css                  # Стили главной страницы
├── README.md                  # Описание проекта
├── AGENTS.md                  # Этот файл с правилами
├── yarn.lock                  # Зависимости
├── images/                    # Общие изображения
│   ├── demo.png
│   ├── github-icon.png
│   └── main-icon.png
├── shared/                    # Общие ресурсы (CSS + JS)
│   ├── common.css             # Дизайн-система: токены, кнопки, футер
│   └── utils.js               # JS-утилиты: DOMUtils, ValidationUtils, ErrorUtils и др.
├── gamma-trainer/             # Приложение "Лады и гаммы — тренажёр"
│   └── AGENTS.md
├── how-many-sp/               # Приложение "Сколько сториков?"
│   └── AGENTS.md
├── triangular-estimation/     # Приложение "Оценка по трём точкам"
│   └── AGENTS.md
├── babylon-tower/             # Игра "Pentagonal Prism Slider" (Three.js)
│   └── AGENTS.md
├── my-valentine/              # Игра "Арканоид-валентинка"
│   └── AGENTS.md
├── tic-tac-toe/               # Игра "Swap-Tac-Toe"
│   └── AGENTS.md
└── the-maze/                  # Игра "Dual Grid Puzzle"
    └── AGENTS.md

Основные правила работы с HTML/CSS/JS приложениями

1. Структура файлов

  • Каждое приложение должно находиться в отдельной папке
  • Используйте стандартные имена файлов: index.html, index.css, index.js
  • Создавайте AGENTS.md в каждой папке с описанием механик

2. HTML правила

  • Используйте семантическую разметку
  • Добавляйте мета-теги для корректного отображения на мобильных устройствах
  • Подключайте шрифты через Google Fonts при необходимости
  • Используйте UTF-8 кодировку для русского текста
  • Добавляйте навигационные ссылки между приложениями

3. CSS правила

  • Используйте современные CSS свойства (flexbox, grid)
  • Применяйте адаптивный дизайн
  • Используйте переменные CSS для цветов и размеров
  • Добавляйте плавные переходы для интерактивных элементов
  • Следите за контрастностью и читаемостью

4. JavaScript правила

  • Используйте современный ES6+ синтаксис
  • Разделяйте логику на функции
  • Добавляйте обработку ошибок
  • Используйте константы для магических чисел
  • Комментируйте сложную логику

5. Общие принципы

  • Каждое приложение должно быть самодостаточным
  • Используйте общие ресурсы (изображения, стили) из корневой папки
  • Следите за производительностью (минимизация запросов, оптимизация изображений)
  • Обеспечивайте доступность (aria-labels, семантическая разметка)

6. Навигация

  • Добавляйте ссылки между приложениями в виде иконок
  • Используйте абсолютные пути для общих ресурсов
  • Добавляйте ссылку на GitHub репозиторий

7. Документация

  • Каждая папка с приложением должна содержать AGENTS.md
  • Описывайте основные механики и алгоритмы
  • Указывайте зависимости и внешние библиотеки
  • Документируйте API и структуру данных

Технический стек

  • HTML5 - семантическая разметка
  • CSS3 - стилизация и анимации
  • Vanilla JavaScript - интерактивность
  • Canvas 2D API - игровой рендеринг (my-valentine, the-maze)
  • Three.js - 3D-рендеринг WebGL (babylon-tower)
  • Google Fonts - типографика
  • Font Awesome - иконки (the-maze)

Разработка

  1. Создавайте новые приложения в отдельных папках
  2. Следуйте существующей структуре файлов
  3. Используйте общие ресурсы из папки images/
  4. Тестируйте на разных устройствах
  5. Оптимизируйте для производительности