Grunt Dev

Розпочни з new-app.md

2. Існуючий додаток

Розпочни з existing-app.md

Таблиця референсів

Завантажуй лише той файл, який стосується поточної задачі.

Загальні правила

• Завжди запускай grunt doctype sync <Name> після будь-яких змін у DocType
• Ніколи не пиши raw SQL — тільки SQLAlchemy або grunt.db.*
• Ніколи не пиши міграції вручну — вони генеруються автоматично через sync
• Завжди async/await — Ґрунт є async-first (FastAPI + SQLAlchemy 2.0)
• Завжди type hints в Python і TypeScript
• Логуй через structlog, не через print() чи logging.basicConfig()
• Секрети — тільки через config.py + env змінні, ніколи в коді
• Бізнес-логіку — в сервісному шарі, не в API endpoints напряму
• Строго дотримуйся стандарту PEP8 для будь-якого коду на Python.
• Використовуй максимально нові версії всіх пакетів і фреймворків, включно з найсвіжішими стабільними версіями Python та Node.js.

Структура відповіді API

// Успіх
{"success": true, "data": {...}, "meta": {"total": 100, "page": 1, "per_page": 20}}

// Помилка
{"success": false, "error": {"code": "VALIDATION_ERROR", "message": "...", "details": []}}

Готовність до модернізації

• Пропонуй стратегію модернізації коду для підтримки оновлення інфраструктури (пакетів, Python, Node.js) до новітніх версій.
• Якщо бачиш, що можна покращити апі, клі, будь-який компонент, документацію, тести - запропонуй покращення. Якщо користувач погодиться - зроби це.
• Якщо бачиш, що можна покращити skill - запропонуй покращення. Якщо користувач погодиться - зроби це. Зверни увагу - зміни треба вносити в grunt-agent-skills.