Przejdź do treści
Biblioteka skilli
Programowanie · Research

discovering-technical-context

/discovering-technical-context

Ustala przed pisaniem zmiany, jakich konwencji trzeba przestrzegać: kontekst techniczny planu, instrukcje projektu (CLAUDE.md, reguły, ADR), wzorce w kodzie i dokumentacja zewnętrzna.

Licencja
MIT
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
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.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

Ustala przed pisaniem zmiany, jakich konwencji trzeba przestrzegać: kontekst techniczny planu, instrukcje projektu (CLAUDE.md, reguły, ADR), wzorce w kodzie i dokumentacja zewnętrzna.

Wyzwalacze z opisu

how does this project do X
Oryginalny opis (EN)

Establishes which conventions a change must follow before it is written, in priority order: the plan's persisted technical context, then project instructions (CLAUDE.md, .claude/rules, decision records), then existing codebase patterns, then external documentation. Use to answer 'how does this project do X' or to fill a plan's Technical Context section.

Jak działa

  1. When to Use
  2. Applicability and Precedence
  3. Non-negotiable Rules
  4. Discovery Procedure
  5. Related Skills
Sekcje z nagłówków SKILL.md, w oryginale · 86 linii, 628 słów
Podgląd SKILL.md
---
name: discovering-technical-context
description: "Establishes which conventions a change must follow before it is written, in priority order: the plan's persisted technical context, then project instructions (CLAUDE.md, .claude/rules, decision records), then existing codebase patterns, then external documentation. Use to answer 'how does this project do X' or to fill a plan's Technical Context section."
when_to_use: "Trigger on: 'how does this project do X', 'what are the conventions here', two parts of one repository disagreeing on a convention, choosing the pattern new code or tests should follow, or populating a plan's Technical Context. Conventions only: implementing is orchestrating-feature-implementation, planning is creating-implementation-plans."
---

# Discovering Technical Context

A systematic way to learn how a project does things before changing it, so new code
is consistent with what exists and conventions are followed rather than reinvented.
The output is often persisted into a plan's Technical Context section, where it saves
every later agent from rediscovering the same facts.

## When to Use

- Before implementing any feature or fix in code you have not worked in recently.
- Before writing tests — unit, integration, or e2e — in an unfamiliar project.
- When two parts of the repository disagree and you must pick a convention.
- When filling the Technical Context section of an implementation plan.

## Applicability and Precedence

This skill is itself a precedence rule: project instructions outrank existing
patterns, which outrank industry best practice. Nothing here overrides an explicit
instruction from the user.

## Non-negotiable Rules

| Severity | Rule |
| --- | --- |
| MUST | Check the plan's Technical Context first. If it is populated, use it as-is and re-discover only what it does not cover. |
| MUST | Treat project instructions (`CLAUDE.md`, path-scoped rules, decision records) as the primary source of truth when they exist. |
| MUST | Mirror existing codebase patterns when instructions are silent — consistency with the code beats theoretical best practice. |
| MUST | Check the exact dependency versions in the project's manifest before consulting external documentation. |
| NEVER | Introduce a new pattern unless the user or the plan explicitly asks for one. |

## Discovery Procedure

Copy this checklist and track progress:

```text
Discovery progress:
- [ ] 0. Persisted context in the plan
- [ ] 1. Project instructions
- [ ] 2. Existing codebase patterns
- [ ] 3. External documentation (only if needed)
- [ ] 4. Apply the decision hierarchy
```

**Step 0 — Persisted context.** If a `*.plan.md` exists for the task and its
Technical Context section is populated, use it and skip to Step 4. Run Steps 1–2 only
for aspects it does not cover.

**Step 1 — Project instructions.** Read, where present: the root `CLAUDE.md` and any
nested ones near the touched files; path-scoped rules under `.claude/rules/`;
decision records (`docs/decisions/` or similar); `CONTRIBUTING.md` or equivalent.
These are the primary source for coding standards, architecture and layering,
stack versions, testing strategy, and naming.

**Step 2 — Existing codebase patterns.** For whatever the instructions leave
unstated, find the nearest similar implementation and replicate its approach:

- **Architecture** — folder structure, layering, module organization.
- **Style and idiom** — naming, formatting, import conventions.
- **Error handling and validation** — how failures are caught, logged, surfaced.
- **Testing** — structure, mocking strategy, assertions, fixtures, test data.
- **Persistence** — migrations, entities, query patterns.
- **API surface** — response shapes, status codes, documentation style.
- **Configuration** — env vars, feature flags, secrets handling.

**Step 3 — External documentation.** Only when neither instructions nor codebase
answer (greenfield project, first use of a pattern): read the official docs for the
exact versions the manifest pins, apply industry standards (OWASP for security,
SOLID and established design patterns where they fit), and document the decisions you
make so they become the project's pattern.

**Step 4 — Apply the decision hierarchy.**

| Context available | Action |
| --- | --- |
| Project instructions cover it | Follow them strictly — they outrank general best practice. |
| Instructions silent, codebase has a pattern | Mirror the existing pattern exactly. |
| Neither exists | Apply documented best practice and record the decision for the next person. |

## Related Skills

Ships in this plugin — if this skill loaded, it is installed.

- [`creating-implementation-plans`](../creating-implementation-plans/SKILL.md) —
  persists what this skill discovers into the plan's Technical Context.

Wersje

W bazie nie ma innych skilli o nazwie discovering-technical-context.

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

  • 100context-engineering
    Pomaga pisać konwencje i sekcję Context w HARNESS.md: kontekst bazy kodu, dokumentacja konwencji i reguły, które da się egzekwować.
  • 100init-project
    Zakłada szkielet projektu: AGENTS.md i CLAUDE.md, reguły, katalog kontekstu, szablony, ADR, etykiety GitHub i strukturę pracy deweloperskiej.
  • 100architecture-decision-records-adr-authoring
    Dokumentuje kluczowe decyzje techniczne w rekordach ADR, opisując kontekst, kompromisy i uzasadnienie wyboru.
  • 95technical-design
    Zamienia wymagania biznesowe w plan techniczny: model danych, kontrakty interfejsów i plan wdrożenia.
  • 100start-project
    Przeprowadza przez techniczny start projektu: ankieta infrastruktury, dokumentacja CLAUDE.md i uporządkowany plan konfiguracji.
  • 90project-documentation
    Pisze README, strony dokumentacji, przewodniki i wpisy techniczne zgodnie z kontekstem projektu z plików GOALS, SCOPE i CONVENTIONS.

Uwagi i zgłoszenia

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