NXT Recursos — Documentação

Esta é a documentação canônica do catálogo NXT. Para navegar items individuais (1058 recursos), use o Catálogo.

3 superfícies da plataforma

Superfície	URL	Pra quê
📚 Docs (você está aqui)	docs.plataforma.app	Schema, guidelines, vocabulários
🗂 Catálogo	catalogo.plataforma.app	Browse navegável dos 1058 recursos com facets
🎨 Assets	assets.plataforma.app	Logos, ícones, marcas, fontes (5300 arquivos)

Mapa de docs

Schema & Vocabulários

• Overview do schema — visão geral
• JSON Schema (v2.json) — validação canônica
• Naming convention (8 RULES) — como nomear slugs
• Datasette queries reference — canned queries do catalogo

Por kind (10 valores)

Cada kind tem playbook próprio explicando detection heuristics, required fields, examples:

• saas-api — APIs SaaS (240 items)
• self-hosted — Software self-host (52 items)
• library — Pacotes importáveis (158 items)
• cli-tool — Binários CLI (16 items)
• ai-model — Modelos de IA (196 items)
• ai-runner — Runners locais (5 items)
• mcp-server — MCP servers (64 items)
• claude-asset — Skills/agents/commands (315 items)
• nxt-internal — Placeholders NXT (8 items)
• asset — Assets visuais (14 items)

Convenções principais

Princípio único

recursos/<slug>/ é a única casa de qualquer recurso. Tudo o mais é symlink ou view gerada.

Vocabulários controlados (closed lists)

7 facets ortogonais, cada um com lista controlada:

Facet	Valores	Cardinalidade
kind	10 (saas-api, self-hosted, library, ...)	single
capabilities	25 (llm-inference, ocr, embedding, ...)	multi
delivery	10 (saas-api, oss-binary, package-pip, ...)	single
domains	12 (infra, dev-tooling, fiscal-br, midia, ...)	multi
license	14 (proprietary, mit, apache-2, agpl, ...)	single
vendor	14 (anthropic, openai, vendor-br, ...)	single
maturity	5 (experimental, beta, production, ...)	single

Plus tags[] (folksonomy aberta — escape hatch).

Como adicionar um novo recurso

1. Criar recursos/<slug>/ (kebab-case ASCII — vide NAMING.md)
2. Escrever index.v2.json seguindo v2.json schema
3. Validar: bun .system/scripts/validate-schema.ts
4. Re-gerar catalogo: bash .system/scripts/update-datasette.sh
5. Item aparece em catalogo.plataforma.app/recursos/items?slug=<seu>

Status do catálogo

• Total items: 1058
• Items com logo: 736 (70%)
• Items low-confidence: 148 (precisam triagem manual)
• Plugins Datasette ativos: 16
• Dashboards: /-/dashboards/nxt-overview