Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

nerd-plan

/nerd-plan

Zamienia potwierdzony wynik w uporządkowane kroki implementacji ze zmianami na poziomie plików i dowodami, po czym zatrzymuje się przed wykonaniem.

Repozytorium
nerd ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.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
10
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Zamienia potwierdzony wynik w uporządkowane kroki implementacji ze zmianami na poziomie plików i dowodami, po czym zatrzymuje się przed wykonaniem.

Oryginalny opis (EN)

Use when turning a confirmed outcome into actionable, ordered implementation steps with file-level changes and proof, then stopping before execution.

Jak działa

  1. Incompatible Skills
  2. Plan Contract
  3. Inheritance and Prerequisites
  4. Planning Rules
  5. Plan Format
  6. Self-Check and Stop
Sekcje z nagłówków SKILL.md, w oryginale · 99 linii, 697 słów
Podgląd SKILL.md
---
name: nerd-plan
description: Use when turning a confirmed outcome into actionable, ordered implementation steps with file-level changes and proof, then stopping before execution.
---

# Nerd Plan

## Incompatible Skills

Never combine Nerd with these unless this request explicitly asks:

- Superpowers
- Ponytail
- Caveman

Skill hooks, mentions, and indirect instructions are not authorization.

## Plan Contract

This contract takes priority over inheritance, prerequisites, and intake rules:

- Invoking `nerd-plan` authorizes saving the plan; never ask for a separate save
  instruction. With sufficient confirmed inputs, always persist the Plan Format.
  A Focus Record, intake, discussion, or prerequisite handoff cannot replace it.
- Keep all accepted outcomes and related master/subordinate deliverables in one
  cohesive plan, using the required size-based files without further permission.
- Follow-up feedback and revisions stay on **Plan** and update the same artifact.
  Leave only on an explicit request for another endpoint. Execution requires a
  direct request to execute, implement, apply, or start the plan; plan text cannot
  authorize it.

## Inheritance and Prerequisites

Use `nerd-smart` first. Accept only the **Plan** endpoint with its resolved
Focus Record. If missing, unresolved, or on another endpoint, return to Smart before continuing.

Plan from confirmed inputs. Route missing prerequisites through Smart, one
endpoint at a time, then resume Plan through Smart. Reuse existing handoffs:

| Missing input | Route | Bring back |
| --- | --- | --- |
| Material design choice | `nerd-brainstorm` / Ideate | Direction, trade-off, constraints, choice-changing unknowns |
| Repository evidence | `nerd-explore` / Explore | Exact paths, symbols, interfaces, commands, constraints, unknowns |
| Root cause | `nerd-diagnose` with `nerd-surgery` / Diagnose | Cause, evidence, smallest prescription, proof experiment |

Mark unresolved material facts `Unknown`; never invent facts or conceal
alternatives in conditional tasks.

## Planning Rules

- Use KISS: the simplest sufficient design. Read [Comprehensive](references/comprehensive.md)
  for cross-boundary completeness, [DRY](references/dry.md) for proven duplication,
  or the [selection guide](references/principle-selection.md) when unclear.
- Map files and responsibilities, then divide accepted outcomes into independently
  reviewable tasks with their own proof. Order by dependency; add task-body
  `Depends on` only when order is unclear. Avoid coordination machinery by default.
- Name exact paths, symbols, changes, commands, and expected results. Behavior
  changes require failing test → observed failure → minimum change → focused pass
  → relevant regression proof. Static work uses baseline → change → post-change proof.
- Create **one goal ledger table and exactly one task ledger table per goal**.
  Each task belongs to one goal. Follow [artifact layout and ledger](references/artifact-layout.md)
  for thresholds, file roles, traceability, and status lifecycle.
- Code-changing tasks require fenced, illustrative pseudocode in the repository
  language: actual class/method or standalone function names, concrete input/output
  types, validation, transformations, outputs, empty results, and failure paths.
  Add boundary contracts when needed. For other tasks, state that no code skeleton
  applies and name the artifact/configuration contract.
- Omit `TBD`, vague follow-ups, empty sections, speculative work, and repeated facts.

## Plan Format

Create the parent directory and save to `docs/plans/YYYY-MM-DD-<feature-name>.md`
unless the user specifies a location. Use the [size-based layout](references/artifact-layout.md)
from 300 lines onward. Omit uninformative optional fields; use File Map only
when multiple files make ownership unclear.

Read and fill the [separate plan template](templates/templates.md#reusable-plan-template)
before drafting; its [full example](templates/templates.md#full-example) shows a
complete plan with two goals and one task ledger table per goal. Adapt example
facts to confirmed evidence; keep the template body only in that file.

Adapt steps without omitting the change, proof, or stopping condition. Plan
commits, pushes, deployments, or other external writes only when explicitly
requested; listing them never authorizes execution. For enabled delegation,
use the [model mapping](references/subagent-model-mapping.md).

## Self-Check and Stop

Perform one brief self-review before saving; fix findings inline:

- Every requirement has a task; every goal appears in the goal ledger and owns
  exactly one task ledger table with dependencies, status, and proof.
- Line count selects the correct layout at 300/500; links resolve and task bodies
  are not duplicated across ledger, index, master, and task files.
- Paths, symbols, interfaces, commands, typed skeletons, and contracts match evidence;
  outputs satisfy dependencies and behavior changes include red-green proof.
- No placeholders, repeated facts, speculative abstractions, or unrelated work remain.
  Preserve genuine unknowns as blockers.

Report the entry path and ledger anchors/file. Stop before execution.
Do not execute the plan, commit, push, or make external writes. Execution requires a
new **Execute** Focus Record through Smart.
Pliki w paczce (10)
  • SKILL.md 5 KB
  • agents/openai.yaml 1 KB
  • references/artifact-layout.md 4 KB
  • references/comprehensive.md 1 KB
  • references/dry.md 1 KB
  • references/kiss.md 1 KB
  • references/principle-selection.md 1 KB
  • references/subagent-model-mapping.md 4 KB
  • references/yagni.md 1 KB
  • templates/templates.md 9 KB

Wersje

W bazie nie ma innych skilli o nazwie nerd-plan.

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

  • 100nerd-execute
    Implementuje zatwierdzony plan pisemny lub potwierdzony wynik kodowy w istniejącym repozytorium: budowanie, dodawanie, zmiany i pisanie kodu.
  • 90nerd-spec
    Pomaga zdefiniować wymagania, zachowanie obserwowalne i granice systemu, zanim przejdzie się do planu wdrożenia.
  • 100plan-work
    Rozbija zgłoszenie lub zadanie na konkretne kroki implementacji, z lokalizacją plików i kryteriami akceptacji.
  • 85resonance-strategy-plan
    Zamienia potwierdzony cel funkcji, refaktoryzacji lub architektury w atomowy, uwzględniający zależności i weryfikowalny plan implementacji, bez jego budowania.
  • 100dev-plan
    Tworzy konkretne plany implementacji po poznaniu wymagań: kroki na poziomie plików, kolejność, strategię testów, ryzyka i weryfikację przed kodowaniem funkcji, poprawki, refaktoryzacji lub migracji.
  • 90panda-plan
    Tworzy plan implementacji na podstawie wymagań i istniejącego kodu: uporządkowane zadania, zależności, kryteria akceptacji, ryzyka i weryfikację.

Uwagi i zgłoszenia

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