> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Навык: Веб-разработка

> Описание работы навыка для веб-задач в Велес: стек технологий, возможности и ограничения.

# Навык: Веб-разработка

`web-development` — это специализированный навык, предназначенный для решения задач по созданию и сопровождению веб-приложений.

Важно понимать, что в стандартной реализации Велес этот навык не является «универсальным помощником по любому фронтенду», а жестко ориентирован на конкретный технологический стек:

* **Next.js**: современный фреймворк для React.
* **SQLite**: в качестве основной базы данных.
* **Drizzle ORM**: для удобного взаимодействия с данными.
* **Railway**: как основное окружение для развертывания (деплоя).

***

## Сценарии использования

Навык приносит максимальную пользу, когда ваш проект уже базируется на указанном выше стеке или вы планируете его создание:

* разработка или модификация веб-приложений на Next.js;
* проектирование и внедрение новых API-маршрутов (API routes);
* реализация операций с базой данных через интерфейсы Drizzle;
* управление жизненным циклом приложения в среде Railway.

***

## Ограничения по стеку

Этот навык не следует воспринимать как общий по веб-разработке. Если вы используете альтернативные технологии, такие как:

* Django или FastAPI (Python);
* Laravel (PHP);
* Ruby on Rails;
* или любой другой backend-фреймворк;

рекомендации и алгоритмы данного навыка могут оказаться частично неактуальными или избыточными.

***

## Возможности навыка

В рамках целевого окружения навык помогает Велес:

* свободно ориентироваться в структуре Next.js App Router;
* корректно проектировать архитектуру в папке `app/api/`;
* эффективно использовать возможности Drizzle ORM для работы с данными;
* учитывать специфику модели развертывания на платформе Railway;
* избегать навязывания архитектурных решений, не подходящих для данного стека.

***

## Почему это важно

Без активации этого навыка Велес может давать слишком обобщенные советы по веб-разработке («сделайте как-нибудь на любом бэкенде»). Навык `web-development` делает поведение Велес конкретным и предсказуемым, опираясь на лучшие практики и соглашения (conventions) выбранного стека.

***

## Примеры запросов

* «Создай новый API-маршрут для управления списком задач».
* «Разработай структуру таблицы и базовые CRUD-операции через Drizzle».
* «Обнови главную страницу в нашем Next.js приложении».
* «Добавь новый эндпоинт (endpoint) в директорию app/api/».

***

## Важные нюансы

* Навык эффективен только при совпадении технологий вашего проекта с целевым стеком.
* Он оптимизирован под инфраструктуру Railway и стандартную структуру современных веб-проектов.
* Для консультаций по технологиям, не входящим в данный список, рекомендуется использовать общий поиск или специализированные навыки.

***

## Связанные страницы

* [Навыки Велеса: технический справочник](/skills/reference_ru)
* [Инструменты Велеса: технический справочник](/dive-deeper/tools_reference_ru)