Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Pisanie

thinkmap-format

/thinkmap-format

Pilnuje formatu planu w folderze docs/plan i zapisuje decyzje do plików planu na bieżąco, podczas rozmowy o projekcie.

Repozytorium
ThinkMap ↗
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

Pilnuje formatu planu w folderze docs/plan i zapisuje decyzje do plików planu na bieżąco, podczas rozmowy o projekcie.

Oryginalny opis (EN)

Use whenever you are planning, discussing, deciding, questioning, suggesting or warning about anything in a project that has a docs/plan/ folder (a Thinkmap plan), and whenever you create or edit a file under docs/plan/. Teaches where the format rules are and the habit of writing decisions into the plan files as the conversation happens.

Jak działa

  1. The one rule about the format
  2. The habit
  3. Where things go
  4. After every edit
  5. Working a ticket
Sekcje z nagłówków SKILL.md, w oryginale · 62 linii, 474 słów
Podgląd SKILL.md
---
name: thinkmap-format
description: Use whenever you are planning, discussing, deciding, questioning, suggesting or warning about anything in a project that has a docs/plan/ folder (a Thinkmap plan), and whenever you create or edit a file under docs/plan/. Teaches where the format rules are and the habit of writing decisions into the plan files as the conversation happens.
user-invocable: false
---

# Thinkmap — write the plan while you talk

This project keeps its planning in `docs/plan/` as Markdown files. A viewer draws them as a
mind map, so every Claude session and every person sees what is decided, open and built.

## The one rule about the format

**The format has exactly one source of truth: `${CLAUDE_PLUGIN_ROOT}/template/FORMAT.md`.**
Read that file before you write or change a plan file. Do not work from memory and do not
look for a copy here — this skill deliberately carries none, so it can never drift from
the validator.

The project may also have its own `docs/plan/FORMAT.md`. That is a **copy** kept for
people and sessions without the plugin, not a second source: never edit it by hand. When
the validator or the session briefing says it is behind the bundled rules, refresh it with

```
node "${CLAUDE_PLUGIN_ROOT}/bin/thinkmap.js" format --write
```

## The habit

While discussing, record things in the plan files **as they happen**, not at the end:

- an agreement → a `decided` point with `What:` and `Why:` lines
- a question nobody answered → an `open` point with `Options:` or `Next:`
- an idea you (Claude) propose → a `suggestion` point tagged with `claude`
- a risk, rule or gotcha to remember → a `caution` point with `Risk:`
- something talked through with no decision → a `discussed` point
- something rejected → a `dropped` point with `Why:` (never delete the line)

Decisions that live only in chat are lost. If the person says "let's decide X", "that is an
open question", "note that we must …", that is your cue to edit the topic file right away.

## Where things go

- A **topic** (`type: feature`) file holds the points under `## Points`. One file per topic.
- A **ticket** (`type: ticket`) is one unit of work; it lives in the phase's `tickets/` folder,
  lists the point IDs it delivers in `implements:`, and has a Handoff log.
- New phase, topic or ticket: copy the shape of an existing file, keep the ID patterns from
  FORMAT.md, and never reuse an ID.
- **Other documents** (a setup guide, architecture notes) go outside the plan folder: the map
  reads only plan files. When one holds decisions or unanswered questions (TODOs), also record
  them as points in a topic, with a link to the document, so they show on the map.

## After every edit

Run the validator and fix anything it reports before you move on:

```
node "${CLAUDE_PLUGIN_ROOT}/bin/thinkmap.js" validate
```

(A hook also runs it automatically after each edit under `docs/plan/`.)

## Working a ticket

Claim it with `/implement-ticket <ID>`: status `in-progress`, your name as owner, a Handoff
log line. Edit only the ticket you own. When finished: tick the acceptance criteria, fill
`code:`, set `done`, and suggest a commit message that ends with `[<ID>]`.

Wersje

W bazie nie ma innych skilli o nazwie thinkmap-format.

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

  • 100implement-ticket
    Obsługuje jeden ticket Thinkmap w dwóch bramkach: najpierw brief tylko do odczytu, a po zgodzie budowę i zamknięcie zgłoszenia.
  • 100plan-format
    Pomaga pisać, poprawiać i naprawiać plik planu implementacji o ustalonej strukturze sekcji.
  • 100create-tickets
    Dzieli zdecydowane punkty fazy P1 albo jeden temat na zgłoszenia i zapisuje pliki dopiero po zatwierdzeniu.
  • 90finalize-plan
    Sprawdza kompletność planu przed akceptacją: czy kluczowe decyzje, nazwy plików, polecenia i ograniczenia trafiły do pliku planu.
  • 100grill-with-docs
    Testuje plan względem języka projektu (CONTEXT.md) i zapisanych decyzji (docs/adr/), aktualizując te pliki na bieżąco, gdy krystalizuje się terminologia i decyzje.
  • 100plan-review
    Sprawdza dokument planu pod kątem jakości i gotowości do sprintu, po wygenerowaniu planu.

Uwagi i zgłoszenia

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