Denozordec
aa4e3d0180
CI / changes (push) Successful in 9s
CI / commitlint (push) Has been skipped
CI / openapi (push) Successful in 25s
CI / web (push) Successful in 31s
CI / go (push) Successful in 2m14s
CI / bird2 (push) Successful in 15s
CI / release (push) Successful in 3m53s
Added Context7 documentation links for stack IDs and skills to the agents guide, enhancing clarity on library usage and integration.
94 lines
4.7 KiB
Plaintext
94 lines
4.7 KiB
Plaintext
---
|
|
description: Context7 — закреплённые ID библиотек и документации стека EvoBGP
|
|
alwaysApply: true
|
|
---
|
|
|
|
# Context7 — стек EvoBGP
|
|
|
|
При вопросах об API, синтаксисе, конфигурации и миграциях библиотек **сначала** `query-docs` с ID из таблицы ниже. Шаг `resolve-library-id` **пропускать**, если библиотека уже перечислена (кроме неоднозначного случая).
|
|
|
|
Локальные версии: `go.mod`, `web/package.json`. При расхождении с ID — предпочитать версию из репозитория.
|
|
|
|
---
|
|
|
|
## Backend (Go)
|
|
|
|
| Библиотека | Context7 ID | Версия в проекте | Когда |
|
|
|------------|-------------|------------------|-------|
|
|
| Go stdlib | `/golang/go/go1_24_6` | Go 1.24 | `net/http`, `context`, тесты, concurrency |
|
|
| pgx | `/websites/pkg_go_dev_github_com_jackc_pgx_v5` | v5.7.2 | PostgreSQL, pool, транзакции, типы |
|
|
| Prometheus Go client | `/prometheus/client_golang` | v1.20.5 | метрики, `/metrics`, middleware |
|
|
| modernc SQLite | `/websites/pkg_go_dev_modernc_org_sqlite` | v1.34.5 | SQLite-бэкенд, миграции sqlite |
|
|
| miekg/dns | `/miekg/dns` | v1.1.72 | DNS-запросы, DoH, pipeline |
|
|
|
|
---
|
|
|
|
## HTTP-контракт и спецификации
|
|
|
|
| Библиотека | Context7 ID | Версия в проекте | Когда |
|
|
|------------|-------------|------------------|-------|
|
|
| OpenAPI | `/oai/openapi-specification` | 3.x в `docs/openapi.yaml` | схемы, operationId, problem+json |
|
|
| Redocly CLI | `/redocly/redocly-cli` | CI `@redocly/cli` | lint OpenAPI, `npx @redocly/cli lint` |
|
|
|
|
---
|
|
|
|
## Web UI (`web/`)
|
|
|
|
| Библиотека | Context7 ID | Версия в проекте | Когда |
|
|
|------------|-------------|------------------|-------|
|
|
| Svelte | `/websites/svelte_dev` | ^5.54 | runes, компоненты, реактивность |
|
|
| SvelteKit | `/sveltejs/kit` | ^2.50 | routing, `load`, adapters, SSR |
|
|
| Vite | `/vitejs/vite/v7.3.1` | ^7.3.1 | dev server, build, plugins |
|
|
| TypeScript | `/microsoft/typescript/v5.9.3` | ^5.9.3 | типы, strict, tsconfig |
|
|
| Tailwind CSS | `/tailwindlabs/tailwindcss.com` | ^4.1 | v4, `@tailwindcss/vite`, утилиты |
|
|
| shadcn-svelte | `/websites/shadcn-svelte` | CLI | примитивы `ui/core`, theming |
|
|
| Bits UI | `/llmstxt/bits-ui_llms_txt` | ^2.17 | headless-примитивы под shadcn |
|
|
| sveltekit-superforms | `/ciscoheat/sveltekit-superforms` | ^2.30 | формы, server actions |
|
|
| Formsnap | `/svecosystem/formsnap` | ^2.0 | доступные поля форм |
|
|
| Zod | `/websites/zod_dev_v4` | ^4.4 | схемы валидации |
|
|
| TanStack Table | `/websites/tanstack_table` | table-core ^8.21 | `AppDataTable`, колонки, сортировка |
|
|
|
|
UI-правила репозитория: `.cursor/rules/web-shadcn.mdc` (shadcn-svelte docs — первичный источник для компонентов).
|
|
|
|
---
|
|
|
|
## Data plane / BGP
|
|
|
|
| Библиотека | Context7 ID | Версия в проекте | Когда |
|
|
|------------|-------------|------------------|-------|
|
|
| BIRD 2 | `/llmstxt/bird_xmsl_dev_llms_txt` | BIRD2 в compose | `birdfmt`, фильтры, протоколы |
|
|
| BIRD (исходники) | `/cz-nic/bird` | — | низкоуровневый синтаксис daemon |
|
|
|
|
Сетевые правила: `.cursor/rules/networking-bird.mdc`.
|
|
|
|
---
|
|
|
|
## DevOps
|
|
|
|
| Библиотека | Context7 ID | Версия в проекте | Когда |
|
|
|------------|-------------|------------------|-------|
|
|
| Docker Compose | `/docker/compose` | `deploy/compose/` | сервисы, profiles, volumes |
|
|
| Docker | `/docker/docs` | — | образы, bake, networking |
|
|
|
|
---
|
|
|
|
## Приоритет источников
|
|
|
|
1. **Контракт HTTP** — `docs/openapi.yaml` (не Context7).
|
|
2. **Context7** — синтаксис и API библиотек из таблицы.
|
|
3. **Локальные docs** — `docs/`, `web/README.md`, `AGENTS.md`.
|
|
4. **Официальный сайт** — BIRD: https://bird.network.cz/?get_doc (если Context7 не покрыл кейс).
|
|
|
|
## Примеры запросов
|
|
|
|
```
|
|
/docs /websites/svelte_dev runes $state $derived
|
|
/docs /golang/go/go1_24_6 net/http ServeMux pattern matching
|
|
/docs /websites/pkg_go_dev_github_com_jackc_pgx_v5 pool acquire rows
|
|
/docs /llmstxt/bird_xmsl_dev_llms_txt filter bgp import
|
|
```
|
|
|
|
## Не через Context7
|
|
|
|
Рефакторинг `internal/*`, бизнес-логика EvoBGP, code review — код репозитория и `codegraph`. Context7 — только внешние библиотеки и инструменты.
|