Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

purpose-sync

/purpose-sync

Pod koniec sesji pracy proponuje aktualizacje drzewa celów projektu, by realized_by odpowiadało temu, co robi kod, i wskazuje zmiany, które nie służą żadnemu celowi.

Repozytorium
Homunculus ↗
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
3
Skrypty
2
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 sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/changes.cjs, tests/changes.test.cjs

Co robi i kiedy

Pod koniec sesji pracy proponuje aktualizacje drzewa celów projektu, by realized_by odpowiadało temu, co robi kod, i wskazuje zmiany, które nie służą żadnemu celowi.

Wyzwalacze z opisu

s purpose tree so each purpose
Oryginalny opis (EN)

At the end of a work session, propose updates to a project's purpose tree so each purpose's realized_by matches what the code now does, and flag changes that serve no purpose. Use when wrapping up a session in a project that has purpose-tree.yaml or architecture.yaml, or when asked to sync the purpose tree.

Jak działa

  1. Steps
  2. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 91 linii, 673 słów
Podgląd SKILL.md
---
name: purpose-sync
description: At the end of a work session, propose updates to a project's purpose tree so each purpose's realized_by matches what the code now does, and flag changes that serve no purpose. Use when wrapping up a session in a project that has purpose-tree.yaml or architecture.yaml, or when asked to sync the purpose tree.
---

Keep the project's purpose tree in step with its implementations. Uses the
[purpose-tree](../purpose-tree/SKILL.md) method; read it first if you have not.

You touch `realized_by` and `last_synced`. A `purpose` changes only when the human
explicitly accepts a session-end review item (step 2b); never edit one on your own.

## Steps

1. **Collect changes.** Run:

   ```bash
   node <this-skill>/scripts/changes.cjs
   ```

   It prints JSON: the tree file, the base commit (the tree's `last_synced`, or the last
   commit that touched the tree), every changed path since then (committed and not), and
   for each path the node ids whose `realized_by` mentions it. Exit 2 = no tree here: stop
   silently.

   **Too many changes?** If `base_source` is not `last_synced` and there are more than
   50 changes, this is a first sync on an old tree. Do not propose anything. Ask one
   question: "Set the sync baseline to HEAD? (purposes stay as they are; run a tree review
   to catch up)". On yes, do only step 5. Print the summary with `proposed=0`.

2. **Decide proposals.** Work from that JSON, not from memory of the session. Use the
   conversation only to understand *why* something changed.
   - A node's implementation was renamed, moved, or deleted → update its `realized_by`.
   - A node gained a new implementation → add it to that node's `realized_by`.
   - A changed path matches no node (`unmatched`) and is real functionality → propose
     which existing purpose it serves. If none fits, flag it as a **gap**; do not invent
     a purpose.
   - A node now has no implementation left → flag it as a **gap**.
   - Tests, formatting, lockfiles, and docs-only edits are not proposals.

2b. **Session-end review.** Look only at the nodes this session touched and their parents.
   Raise a **review** item when one of these holds:
   - (a) Several implementations of the same purpose were replaced in this session.
   - (b) The node is in `churn`: its `realized_by` already changed 3+ times in 30 days.
     Endless tweaking usually means the purpose is unclear (rabbit-holing).
   - (c) New functionality fits no purpose and looks like a new direction, not a stray file.
   A review item is a question, not an edit: "Is `<id>` still about '<purpose>'?" or "Is
   this a new purpose, or should it not exist?". If the human answers with a new wording,
   apply it; otherwise change nothing. Use the conversation to judge (a) and (c); do not
   go back to older sessions.

3. **If there is nothing to propose: say nothing.** Still do step 5 (advance
   `last_synced`) and print the summary line.

4. **Otherwise ask once.** One numbered list, then one question:

   ```
   Purpose tree — 3 proposals
   1. daily_awareness: realized_by "cron brief" → "scripts/brief.js"
   2. offline_reading: add "app/cache/"
   3. gap: scripts/export.js serves no purpose — which purpose is it for?
   4. review: daily_awareness changed 4 times in 30 days — still "Know what matters before the day starts"?
   Accept all? (or e.g. "reject 2", "3: serves sync_progress")
   ```

   Do not ask follow-up questions. Anything left unanswered counts as rejected.

5. **Apply.** Edit only the accepted `realized_by` entries. Set the top-level
   `last_synced:` to the current `HEAD` commit, even when everything was rejected, so the
   same changes are not proposed again. Then validate:

   ```bash
   node <purpose-tree-skill>/scripts/validate.cjs
   ```

   If validation fails, fix your edit or revert it. Never leave an invalid tree.

6. **Print the summary line** as the last line of your output, exactly:

   ```
   purpose-sync: proposed=<N> accepted=<N> rejected=<N> gaps=<N> reviews=<N>
   ```

   `reviews` counts the review items raised in step 2b.

   This skill stores nothing else. A host that wants to learn from these numbers reads
   this line.

## Rules

- Proposal size matches the node's level: a lower node gets a path; an upper node gets
  at most a short phrase. If you want to change an upper node, raise a review item instead.
- For a tree-wide check (gaps outside this session, stale nodes, failing health checks),
  the human runs the `purpose-review` skill. Do not do that here.
- Commit nothing yourself unless the user asks; the tree edit is part of their work.
Pliki w paczce (3)
  • SKILL.md 5 KB
  • scripts/changes.cjs 4 KB
  • tests/changes.test.cjs 6 KB

Wersje

W bazie nie ma innych skilli o nazwie purpose-sync.

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

  • 100purpose-tree
    Opisuje metodę drzewa celów: jak czytać, pisać i sprawdzać pliki purpose-tree.yaml i architecture.yaml oraz oceniać, czy zmiana służy celom projektu.
  • 100purpose-review
    Buduje drzewo celów dla projektu, który go nie ma, albo przegląda istniejące: luki w całym drzewie, nieistniejące implementacje, nieaktualne węzły i nieprzechodzące kontrole.
  • 100github-sync
    Przegląda zmiany Git z sesji, streszcza je do zatwierdzenia, a następnie robi commit i push na GitHub.
  • 86end-session
    Zamyka sesję pracy: sprawdza testy, aktualizuje ROADMAP i HANDOFF oraz wskazuje zmiany, które nie są w commicie.
  • 100yaml-master
    Prawdopodobnie wspiera pracę z plikami YAML i aktywuje się automatycznie, gdy wykryje kontekst YAML.
  • 100yaml-master
    Prawdopodobnie wspiera pracę z plikami YAML i aktywuje się automatycznie, gdy wykryje kontekst YAML.

Uwagi i zgłoszenia

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