Przejdź do treści
Biblioteka skilli
Programowanie · Research

context

/context

Znajduje decyzje architektoniczne ADR istotne dla zadania przed implementacją, w tym ograniczenia i przyczyny obecnego projektu, w trybie tylko do odczytu.

Repozytorium
adr-kit ↗
Licencja
MIT
Ostatnia zmiana repozytorium
24.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
0
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Znajduje decyzje architektoniczne ADR istotne dla zadania przed implementacją, w tym ograniczenia i przyczyny obecnego projektu, w trybie tylko do odczytu.

Argumenty

/context [topic or task description; e.g. \"mqtt discovery\"]
Oryginalny opis (EN)

Find ADRs relevant to a task before implementation. Use for ADR context, governing decisions, architecture constraints, or why a design exists. Read-only.

Jak działa

  1. Procedure
  2. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 73 linii, 526 słów
Podgląd SKILL.md
---
name: context
description: "Find ADRs relevant to a task before implementation. Use for ADR context, governing decisions, architecture constraints, or why a design exists. Read-only."
argument-hint: "[topic or task description; e.g. \"mqtt discovery\"]"
license: MIT
allowed-tools: [Read, Bash]
---

# adr-kit context

Reply in the language the user writes in; default to English. Keep command output, identifiers, paths, and ADR file content unchanged.

Use `$ARGUMENTS` as the task topic. If empty, use the current user request or
ask for one short topic when the request does not identify one.

You are running `/adr-kit:context`. Purpose: surface the ADRs that constrain the
task at hand **before** writing code, so you implement within existing decisions
instead of rediscovering or contradicting them. This is read-only — it never
edits ADRs or code, so it is safe to call from parallel subagents.

## Procedure

1. Take the topic from the argument. If none was given, ask the user for a short
   topic or task description (one phrase is enough).

2. Treat schema-v2 `docs/adr/ADR-INDEX.json` as the generated local query
   database. Never treat it as the decision authority or edit it by hand; source
   Markdown remains authoritative. Run the shared deterministic query engine
   from the project root and keep the default limit of 5:

   ```bash
   python <adr-kit-plugin-path>/bin/adr-context --format json --limit 5 "<topic>"
   ```

   - Use `--adr-dir <path>` if the project keeps ADRs somewhere other than
     `docs/adr/`.
   - Use `--min-score <0-1>` to tighten or loosen the relevance cutoff
     (default `0.1`).
   - Include known `--paths`, `--components`, `--symbols`, or `--topics`.
     Filter with `--status` or `--authority`; use `--history` only when the
     task needs Rejected, Superseded, or Deprecated rationale.
   - Keep governing Accepted and advisory Proposed results separate.
   - If the JSON graph is missing or stale, report the fallback and
     `python bin/adr-index docs/adr` as the repair command. Use
     `--strict-index` when fallback would be unsafe.

3. **If the result is an empty list (`[]`)**: tell the user plainly —
   *"No ADRs match '<topic>'; all existing ADRs may apply, or none constrain
   this work."* Do not invent relevance. Stop here.

4. **Otherwise**, for each returned ADR, `Read` the file and present it as
   readable context, not just a filename:

   - **`ADR-NNN — <title>`** (relevance: `<score>`)
   - returned status and format;
   - returned decision summary, authority, role, and matched signals;
   - declared related ADR ids when they explain the match;
   - file path, then `Read` that source ADR before stating a binding constraint.

   Order by relevance (highest first), most relevant ADR last in your message so
   it stays closest to the work that follows.

5. Briefly state the net constraint: in one or two sentences, what these
   decisions require or forbid for the task. Then proceed with (or hand back to)
   the implementation.

## Boundaries

- Read-only. Never modify ADRs, code, or status during a context load.
- Report relevance honestly — a low score means "weakly related", not "must
  comply". Do not inflate scores to seem thorough.
- The ranker is a heuristic. If the user mentions a decision you do not see in
  the results, widen with a different topic or lower `--min-score` rather than
  assuming no ADR exists.
- Query the index first and open only returned sources; do not scan every ADR
  merely to discover relevance.
- Loading context is not approval to violate a decision. If the task conflicts
  with an Accepted ADR, surface the conflict and use `/adr-kit:judge` or
  `/adr-kit:adr` to resolve it.

Wersje

RepozytoriumWynikLicencja
Ta strona · rvdbreemen/adr-kit100MIT
ADWilkinson/astack100MIT
rubycatco/herdr-fleet100MIT
pawangai/pawang-agents100MIT
nocodework/growth-os100MIT
k1p1l0/claude-telegram-supercharged100Apache-2.0
muon-m2/magento2-tools100MIT
e-reitbauer/habits90MIT
nicknisi/sessions90MIT

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

  • 100ce-adr-consult
    Mapuje proponowaną zmianę na obowiązujące ADR i ograniczenia przed implementacją, aby sprawdzić ich stosowalność i konflikty.
  • 100decisions
    Zapisuje decyzje architektoniczne jako krótkie ADR w docs/adr i prowadzi słownik pojęć projektu w GLOSSARY.md.
  • 100adr
    Dokumentuje decyzje architektoniczne z automatyczną numeracją według wzorca ADR.
  • 95documentation-and-adrs
    Zapisuje decyzje architektoniczne (ADR) i uzasadnienia projektowe, a także kontekst przy zmianach publicznych API i wydaniach.
  • 100documentation-and-adrs
    Zapisuje decyzje architektoniczne jako ADR i uzasadnienia projektowe, zwłaszcza przy zmianach publicznego API i wdrażaniu funkcji.
  • 100adr
    Czyta i zapisuje rekordy decyzji w docs/adr, gdy zapadają decyzje albo przed zmianami w obszarach objętych ADR.

Uwagi i zgłoszenia

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