Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

feature-map

/feature-map

Utrzymuje kanoniczną mapę funkcji LangWatch (feature-map.json) i FEATURE_MAP.md, zapisując dodane lub zmienione funkcje, przestrzenie REST, trasy UI, narzędzia MCP, polecenia CLI i skille.

Repozytorium
langwatch ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Utrzymuje kanoniczną mapę funkcji LangWatch (feature-map.json) i FEATURE_MAP.md, zapisując dodane lub zmienione funkcje, przestrzenie REST, trasy UI, narzędzia MCP, polecenia CLI i skille.

Argumenty

/feature-map [what changed, e.g. 'added dataset MCP tools']
Oryginalny opis (EN)

Maintain the canonical LangWatch feature map (feature-map.json at the repo root) and its human-readable companion FEATURE_MAP.md. Use when adding or renaming a feature, a REST namespace, a UI route, an MCP tool, a CLI command or a user-facing skill, so the central registry keeps naming what the code actually serves. Every entry is validated against the code that provides it.

Jak działa

  1. The entry shape
  2. Where each surface actually comes from
  3. Updating
  4. Report
Sekcje z nagłówków SKILL.md, w oryginale · 76 linii, 484 słów
Podgląd SKILL.md
---
name: feature-map
description: "Maintain the canonical LangWatch feature map (feature-map.json at the repo root) and its human-readable companion FEATURE_MAP.md. Use when adding or renaming a feature, a REST namespace, a UI route, an MCP tool, a CLI command or a user-facing skill, so the central registry keeps naming what the code actually serves. Every entry is validated against the code that provides it."
user-invocable: true
argument-hint: "[what changed, e.g. 'added dataset MCP tools']"
---

# Maintain the feature map

`feature-map.json` at the repo root is the product's public information architecture:
the top-level categories (the `features` array; count them in the file, not here), each with `children`, each child a feature with its `surfaces`.
`FEATURE_MAP.md` is the coverage table derived from it — edit both in one change. Use the
underscore form; never create `FEATURE-MAP.md`.

A **feature** here is a customer-facing capability, a row in this map, named the way a
user would name it. It is not the same thing as a **module** (`modules/<name>`,
the contract, process, browser and client packages); one feature can be served by several modules, and
one module can serve several features.

## The entry shape

```json
{
  "id": "observability.tracing",
  "name": "Tracing",
  "description": "Capture LLM calls, spans, inputs/outputs, costs, and latency",
  "surfaces": {
    "code": {
      "sdk": { "python": "…", "typescript": "…", "go": "…" },
      "cli": ["trace search"],
      "hints": {},
      "skill": "tracing",
      "docs": "https://…"
    },
    "platform": { "ui": "/traces", "mcp": ["search_traces"], "skill": null, "docs": null },
    "api": "/api/collector",
    "docs": "https://…"
  },
  "sync": "code-to-platform",
  "produces": ["traces"],
  "consumes": []
}
```

- `code` is what a developer writes in their own project; `platform` is the UI and MCP.
  `api` and `docs` are cross-cutting.
- Values are namespaces, not methods: `"langwatch.experiment"` means the module.
- `sync`: `null` (one mode only), `"bidirectional"`, `"code-to-platform"`,
  `"platform-to-code"`. Future intent goes in `plannedSync`, never in `sync`.
- `hints` carries a copy-pasteable example per CLI command.
- No aspirational entries. If the code does not serve it, it is not in the map.

## Where each surface actually comes from

| Field             | Verify against                                                                                                                     |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `surfaces.api`    | `modules/<f>/process/src/transport/*.rest.ts` (`defineRestRouter`), mounted by the module's installation in `apps/api` (record §8) |
| tRPC namespaces   | `modules/<f>/process/src/transport/*.trpc.ts`                                                                                      |
| `platform.ui`     | `apps/ui/src/shell/ui-route-table.ts` (the `path` of a route descriptor)                                                           |
| sidebar placement | `modules/navigation/browser/src/model/` (`project-nav-items.ts`, `section-nav-items.ts`)                                           |
| `platform.mcp`    | `mcp/typescript/src/create-mcp-server.ts` (`registerTools`) over `mcp/typescript/src/tools/`                                       |
| `code.cli`        | `sdks/typescript/src/cli/commands/` — one directory per command group, `sdks/typescript/src/cli/index.ts` is the entry             |
| `code.skill`      | `skills/<name>/SKILL.md` (the user-facing skills, not `.claude/skills`)                                                            |
| `code.sdk`        | `sdks/python/src/langwatch/__init__.py`, `sdks/typescript/src/index.ts`, `sdks/go/`                                                |

## Updating

1. Read `feature-map.json`, find the feature by `id` (dotted: `category.feature`).
2. Add the value to the right surface array or field. A brand-new feature gets a whole
   entry under the category whose mental model it belongs to — the hierarchy is the
   product's, not the code's.
3. Mirror the change in `FEATURE_MAP.md`.
4. Validate every field you touched against the table above with `ls` / `grep -rn`
   (ripgrep is unreliable in this repo). An entry that names something the code does not
   serve is worse than a missing one.
5. A route rename must update this file: it is a live surface, not documentation.

## Report

The entries added or changed, the code path each was validated against, and anything you
found in the map that the code no longer serves.

Wersje

RepozytoriumWynikLicencja
Ta strona · langwatch/langwatch100Apache-2.0
dababonpro/human-approved-agents100MIT
leather-io/mono100MIT
onyx-dot-app/onyx90MIT

Migawka bazy z 13.11.2026 · wersja paczki 32c00adf2199 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100prove-e2e-maintain
    Sprawdza skill weryfikacji i mapę funkcji względem kodu, uruchamia każdą funkcję i proponuje poprawki w jednym pull requeście.
  • 100maintain-verification-skill
    Okresowo sprawdza skill weryfikacyjny projektu i mapę funkcji: czyta kod równolegle, testuje funkcje na żywo i poprawia dowiedzione błędy.
  • 100maintain-verification-skill
    Okresowo sprawdza skill weryfikacyjny projektu i mapę funkcji: czyta kod równolegle, testuje funkcje na żywo i poprawia dowiedzione błędy.
  • 100maintain-verification-skill
    Okresowo sprawdza skill weryfikacyjny projektu i mapę funkcji: czyta kod równolegle, testuje funkcje na żywo i poprawia dowiedzione błędy.
  • 100maintain-verification-skill
    Okresowo sprawdza skill weryfikacyjny projektu i mapę funkcji: czyta kod równolegle, testuje funkcje na żywo i poprawia dowiedzione błędy.
  • 100maintain-verification-skill
    Okresowo sprawdza skill weryfikacyjny projektu i mapę funkcji: czyta kod równolegle, testuje funkcje na żywo i poprawia dowiedzione błędy.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.