Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

plan-work

/plan-work

Zamienia zatwierdzoną specyfikację w plan oparty na prawdziwym kodzie, z projektem, maszynami stanów i sprawdzalnymi plasterkami, bez pisania kodu.

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

Brak sygnałów. Repozytorium zmienione 05.11.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 zatwierdzoną specyfikację w plan oparty na prawdziwym kodzie, z projektem, maszynami stanów i sprawdzalnymi plasterkami, bez pisania kodu.

Oryginalny opis (EN)

Turn an approved spec or brief into a plan grounded in the real code, with the design, state machines, and verifiable slices, slice 1 in the real environment. Writes no code. Use when asked to plan the work in a spec or brief, plan a feature, or prepare an implementation plan.

Jak działa

  1. 1. Check it's ready to plan
  2. 2. Ground it in the code
  3. 3. Settle forks by running them
  4. 4. Write the plan
  5. 5. Hand it over
Sekcje z nagłówków SKILL.md, w oryginale · 42 linii, 546 słów
Podgląd SKILL.md
---
name: plan-work
description: Turn an approved spec or brief into a plan grounded in the real code, with the design, state machines, and verifiable slices, slice 1 in the real environment. Writes no code. Use when asked to plan the work in a spec or brief, plan a feature, or prepare an implementation plan.
---

# Plan the work

The plan is how the builder will meet the spec, in slices the owner can check. It writes no code. The product's `docs/PROCESS.md` (Planning) holds the rules; this skill is how to do them well.

## 1. Check it's ready to plan

- Read the spec or brief, and `docs/STATUS.md`.
- The spec's "Open decisions" must be empty. If the plan would depend on a product choice the spec doesn't settle, ask the owner now. Models review a plan's consistency, not the owner's intent.

## 2. Ground it in the code

Explore before designing. For a large codebase, send a subagent per area and keep only its findings in your context. Find, with `file:line`:

- similar features to mirror, and how they name things, handle errors and test;
- the types, schemas and boundaries the work touches;
- the real check command and the narrower test commands. Read them from the manifests and `docs/PROCESS.md`. Never guess them.

If the product has `docs/AGENT_STANDARDS.md`, the design follows it, and slice 1 adopts the checks it lists. `~/.master/kits/agent/example/PLAN.md` shows the shape of an agent product's design.

## 3. Settle forks by running them

For each question a document can't settle (which approach is fast enough, which layout works, whether a library does what it claims), build the cheapest probe or throwaway prototype that answers it, in a scratch folder. Say first what result would change the choice. Record what it showed under "Choices and why". Ask the owner only about product or taste choices no run can settle.

## 4. Write the plan

Copy `docs/templates/PLAN.md` to `docs/PLAN.md` (for the spec) or `docs/PLAN_<NAME>.md`, and fill it:

- **Design.** The modules, what each is for, what each uses, and the existing code each mirrors. Check it against `docs/CODE_STANDARDS.md` before writing slices.
- **State machines** as tables, with what each move refuses.
- **Slices.** Each is one change that can be verified on its own, usually a thin path through every layer that a user could see working. Slice 1 is the thinnest end-to-end path, in the real delivery environment. Slices for running the product (noticing a failure, the diagnostic, restore, rollback) come where they belong, not last.
- **Criteria** per slice, checkable from outside: a test, a command and its output, an API response, a page.
- **A wide change** (a rename or retype across many call sites) can't be one thin slice: expand (add the new form beside the old), migrate the callers in slices, then contract (delete the old form) in a last slice that depends on every migration.
- **One stream by default.** Name two slices as parallel only when the plan states the shared contracts (schema, API, state) that make them independent.
- **Every spec line covered.** Where a line can't be met, say so under "Choices and why". Never quietly drop or weaken it.

## 5. Hand it over

Run the plan review the protocol asks for (the `cross-review` skill, with a plan as the unit). Then show the owner the plan's path, its slices in one line each, what the probes settled, and the review's outcome. Stop. Building starts on the owner's word.

Adapted from the owner's earlier `plan-feature`, pstack's prototype playbook and Matt Pocock's `to-tickets` (MIT). See `CREDITS.md` in master.

Wersje

RepozytoriumWynikLicencja
Ta strona · hiteshdundi01/shipwright100MIT
yowcow/dude100MIT
pinkroosterai/PinkRoosterSkills100MIT
daniel-kindl/dkstack100MIT
znorris/claude-marketplace100MIT

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

  • 100plan
    Zamienia zatwierdzoną specyfikację w plan zadań z dokładnymi ścieżkami i sprawdzalną weryfikacją, zanim zacznie się implementacja, bez pisania kodu.
  • 100writing-plans
    Zamienia zatwierdzoną specyfikację w plan pionowych plasterków z plikami, testami i przeglądem ryzyka przed startem.
  • 100implementation-plan
    Tworzy plan przyrostowy dla aktywnego zadania w IMPLEMENTATION_PLAN.md i aktualizuje TASK_STATE.md: najmniejsze bezpieczne wycinki z zakresem, walidacją i kryteriami wyjścia, bez pisania kodu.
  • 100planning-and-task-breakdown
    Zamienia specyfikację w uporządkowane plasterki, po jednym na pull request lub brief dla pracownika, z gotowym sprawdzeniem końca każdego.
  • 96plan
    Zamienia zatwierdzoną specyfikację QRSPI na etapy wdrożenia, które da się wykonać po kolei.
  • 100write-plan
    Zamienia specyfikację w plan implementacji z uporządkowanymi krokami, testami i wycofaniem, bez edycji kodu źródłowego.

Uwagi i zgłoszenia

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