Przejdź do treści
Biblioteka skilli
Dane i analityka · Budowanie i kod

damapl-system-map

/damapl-system-map

Proponuje wpisy pojęć dla notatek systemów i buduje mapę systemów z zatwierdzonych powiązań.

Licencja
Apache-2.0
Ostatnia zmiana repozytorium
03.11.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
3
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 03.11.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 sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/arch_common.py, scripts/map_build.py

Co robi i kiedy

Proponuje wpisy pojęć dla notatek systemów i buduje mapę systemów z zatwierdzonych powiązań.

Oryginalny opis (EN)

Proposes concepts entries for system notes and builds the system map from approved links. Use when a system note needs term links or the concept-to-system map must be regenerated.

Jak działa

  1. Paths
  2. Steps
  3. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 40 linii, 297 słów
Podgląd SKILL.md
---
name: damapl-system-map
description: "Proposes concepts entries for system notes and builds the system map from approved links. Use when a system note needs term links or the concept-to-system map must be regenerated."
version: "0.1.0"
date: "2026-10-31"
summary: "Skill that tells an agent how to propose concept links in system notes for human approval and then build the deterministic system map."
owner: "Data Architect AI Tools maintainers"
status: "release-candidate"
updated: "2026-10-31"
review_by: "2027-01-31"
confidentiality: "public"
---

# System map

Turn system notes into a map of which systems use which glossary terms.

## Paths

Run the scripts from the folder this SKILL.md was loaded from (written `<this skill folder>` below). Take the data folders from the user or, if the file exists, from `.ai/damapl.config.json` in the project root (keys `systems`, `glossary`, `generated`). If neither gives a path, ask the user. Never assume a demo folder.

## Steps

1. Read the system note and its source note. Use only what the source states.
2. Add or extend a `concepts:` list in the note's frontmatter. One entry per term:

   ```yaml
   concepts:
     - term: device-unit      # glossary term id, kebab-case
       meaning: "Physical unit with a serial number"
       source: "DEVICE-REGISTRY-ARCH-v1"   # source_id of the cited note
       status: proposed
   ```

3. Always write `status: proposed`. Never write `approved`; a human sets it after review. Never set `rejected` on your own.
4. Every entry needs `term`, `meaning`, `source` and a status. The source must be an existing `source_id`.
5. If the same term id has different meanings in two systems, or two term ids look alike (for example `device-model` and `device-unit`), keep both entries and tell the human. Do not merge or pick one.
6. After the human has approved entries, run:

   ```bash
   python3 <this skill folder>/scripts/map_build.py --systems SYSTEMS_DIR --out GENERATED_DIR/architecture/map.md
   ```

   Add `--include-superseded` to include older versions of a system note. By default a note whose `source_id` is named in another note's `supersedes` is skipped.
7. Check each entry yourself: it has `term`, `meaning`, `source` and a status, and the `source` is an existing `source_id`.

## Rules

- The map uses approved entries only.
- Shared-term links do not prove an observed data flow. Say so when you present the map.
- Cite the source for every claim.
Pliki w paczce (3)
  • SKILL.md 2 KB
  • scripts/arch_common.py 3 KB
  • scripts/map_build.py 3 KB

Wersje

W bazie nie ma innych skilli o nazwie damapl-system-map.

Migawka bazy z 13.11.2026 · wersja paczki 1446ca22f6d4 (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

  • 100damapl-gap-list
    Buduje listę luk z zatwierdzonych powiązań i słownika oraz pomaga przejść przez konflikty znaczeń i nieużywane terminy.
  • 100damapl-model-change
    Proponuje zmianę modelu na podstawie różnic w notatce systemu, mapy systemów i listy luk, zapisaną jako decyzję ze statusem propozycji.
  • 100connect-notes
    Znajduje powiązania między notatkami, takie jak wspólne idee, sprzeczności i pytania bez odpowiedzi, i proponuje linki lub notatkę-hub z uzasadnieniem.

Uwagi i zgłoszenia

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