Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

deviation-rules

/deviation-rules

Podaje trzy poziomy eskalacji na wypadek, gdy plan rozchodzi się z rzeczywistością podczas budowy, i wskazuje, jak obsłużyć awarie.

Repozytorium
ship ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.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 25.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

Podaje trzy poziomy eskalacji na wypadek, gdy plan rozchodzi się z rzeczywistością podczas budowy, i wskazuje, jak obsłużyć awarie.

Oryginalny opis (EN)

Use when plan diverges from reality during build execution — provides 3 escalation levels for handling failures

Jak działa

  1. Rule 1 — Fix and Continue
  2. Rule 2 — Fix with Limits
  3. Rule 3 — Stop and Report
Sekcje z nagłówków SKILL.md, w oryginale · 52 linii, 337 słów
Podgląd SKILL.md
---
name: deviation-rules
description: Use when plan diverges from reality during build execution — provides 3 escalation levels for handling failures
effort: medium
user-invocable: false
---

# Deviation Rules

During build execution, follow these rules when the plan does not match reality.

---

## Rule 1 — Fix and Continue

**Trigger:** A file path, function name, minor implementation detail, or missing dependency in the plan is wrong or outdated.

**Action:** Make the correct change (fix the path, install the dependency, adjust the detail). Continue executing the next task.

**Examples:**
- Plan says `src/auth/login.ts` but the file is `src/auth/auth.ts` — fix it, move on.
- Plan calls `import bcrypt` but bcrypt isn't installed — install it, move on.

---

## Rule 2 — Fix with Limits

**Trigger:** The `<verify>` command for a task fails after implementation.

**Action:** Debug systematically, then fix and re-verify. Maximum **3 attempts**. Track each attempt.

**Debugging protocol (before each fix attempt):**
1. **Read the error** — full output, stack trace, exit code. The error message often contains the answer.
2. **Trace the cause** — where does the bad value originate? Follow it backward, not forward.
3. **One fix at a time** — change one thing, re-verify. Never batch multiple fixes.

If verify still fails after the third attempt, escalate to Rule 3.

**If each fix reveals a new problem in a different place:** This is not a single bug — it's an architectural mismatch. Skip directly to Rule 3.

**Do not:** Skip the verify step. Do not proceed to the next task with a broken current task. Do not guess — read the error first.

---

## Rule 3 — Stop and Report

**Trigger:** An architectural conflict, persistent verification failure (3 attempts exhausted), or any issue that requires fundamentally rethinking the approach.

**Action:**
1. Stop execution immediately
2. Leave the feature status as `building` in CONTEXT.md
3. Output `## CHECKPOINT REACHED` with a clear explanation and recommendation

**Signals:**
- Plan assumes REST API but codebase uses GraphQL — replanning needed, not improvisation
- Each fix attempt reveals a new problem in a different place — architectural mismatch
- Fix requires "massive refactoring" to implement — wrong approach, not wrong code

Wersje

W bazie nie ma innych skilli o nazwie deviation-rules.

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

  • 100log-deviation
    Zapisuje miejsce, w którym kod wymusił odstępstwo od uzgodnionego planu, w trakcie implementacji, aby rejestr zasilał przyszłe planowanie i quiz przy scalaniu.
  • 90dev-implement
    Wykonuje zatwierdzony plan zadanie po zadaniu, sprawdza każdy plik i zatrzymuje się przy błędach budowania lub typów.
  • 92kmg-execute-plan
    Wymusza wykonanie planu bez odstępstw, gdy użytkownik poleca realizację zatwierdzonego planu wdrożenia.
  • 90executing-plans
    Realizuje zatwierdzony plan jedno zadanie naraz, z weryfikacją między zadaniami, i zatrzymuje się, gdy rzeczywistość odbiega od planu.
  • 90agent-plan-execute-replan
    Oddziela planowanie od wykonania i przeplanowuje, gdy rzeczywistość się rozchodzi, aby długie zadanie nie realizowało planu, który przestał być prawdziwy.
  • 100docs-as-code
    Traktuje dokumentację jak kod: trzyma ją w repozytorium, przegląda w pull requestach, sprawdza w CI i buduje podglądy, gdy dokumentacja rozjeżdża się z rzeczywistością.

Uwagi i zgłoszenia

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