fpf-sync
/fpf-sync
Synchronizuje skill fpf-core z kanonicznego monolitu FPF-Spec.md, gdy specyfikacja FPF się zmieniła lub referencje skilla są nieaktualne, w ramach cyklicznej konserwacji.
- Autor
- dimonier ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 18.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 4
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 18.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 4 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/_common.py, scripts/decompose_fpf.py, scripts/errors.py, scripts/sync_fpf_core.py
Co robi i kiedy
Synchronizuje skill fpf-core z kanonicznego monolitu FPF-Spec.md, gdy specyfikacja FPF się zmieniła lub referencje skilla są nieaktualne, w ramach cyklicznej konserwacji.
Oryginalny opis (EN)
Sync the fpf-core skill from the canonical FPF-Spec.md monolith. Use when: (1) the FPF specification has been updated (git pull shows new commits), (2) the fpf-core skill references/ are stale or show wrong counts, (3) running scheduled maintenance on LFW skills. Self-contained — bundles decompose_fpf.py + _common.py directly. No dependencies on external skills. Works only with the local skill at `../fpf-core/` (relative to this skill) — NOT the global user skill.
Jak działa
- Quick Start
- Workflow
- Scripts
- Error Handling
- SDC Alignment
- Evolution
Podgląd SKILL.md
--- name: fpf-sync description: | Sync the fpf-core skill from the canonical FPF-Spec.md monolith. Use when: (1) the FPF specification has been updated (git pull shows new commits), (2) the fpf-core skill references/ are stale or show wrong counts, (3) running scheduled maintenance on LFW skills. Self-contained — bundles decompose_fpf.py + _common.py directly. No dependencies on external skills. Works only with the local skill at `../fpf-core/` (relative to this skill) — NOT the global user skill. --- # FPF Core Skill Sync **Bounded context:** Keeping `../fpf-core/` in sync with the canonical FPF monolith `../../FPF-Spec.md`. **Self-contained** — all decomposition logic is bundled in `scripts/`. No external skill dependencies. Requires only Python 3.10+ and `git` in PATH. ## Quick Start ```bash # Check if update is needed (exit code 0=up-to-date, 1=needs update): python scripts/sync_fpf_core.py --check # Full sync (git pull + copy + decompose + update SKILL.md): python scripts/sync_fpf_core.py # Preview without writing: python scripts/sync_fpf_core.py --dry-run # Sync without running git pull (use local state): python scripts/sync_fpf_core.py --no-git ``` ## Workflow The script performs these steps in order: 1. **`git pull`** in repo root (`../..`) — fetch latest FPF-Spec.md 2. **Compare hashes** — `FPF-Spec.md` vs `skills/fpf-core/assets/FPF-Spec.md`. If identical, exit cleanly 3. **Copy monolith** — updated `FPF-Spec.md` → `skills/fpf-core/assets/FPF-Spec.md` 4. **Decompose** — calls bundled `decompose_fpf.parse_fpf_spec()` to rebuild all `references/*.md` + `INDEX.md` from the monolith. Uses idempotent writes — only changed files are overwritten 5. **Update `SKILL.md`** — refreshes line count (e.g. `100K+`) and reference counts (`291 pattern reference files + INDEX + 34 context sections`) 6. **Report** — prints counts, warnings, and errors ## Scripts | File | Role | Size | |---|---|---| | `sync_fpf_core.py` | Orchestrator: git pull → diff → copy → decompose → update SKILL.md | 7 KB | | `decompose_fpf.py` | FPF monolith parser: ToC parsing, `:End`-marker boundary detection, pattern extraction | 15 KB | | `_common.py` | Shared utilities: reference formatting, YAML frontmatter, idempotent writes, INDEX generation | 7 KB | | `errors.py` | Error types for pattern extraction | 1 KB | ## Error Handling | Situation | Script behavior | |---|---| | `git pull` fails (network, auth) | Warning — continues with local state | | Source `FPF-Spec.md` missing | Error — exits with code 2 | | Decomposition produces warnings | Printed — exits with code 0 (non-fatal) | | Decomposition produces errors | Printed — exits with code 1 | | No changes detected | Exits cleanly with code 0 | ## SDC Alignment This skill implements `SDC.SyncDiscipline` (Spec-Decomposer LPF) for the specific case of the `fpf-core` skill: - **Unidirectional sync** (`AS.10:4.1`): monolith → references. Never the reverse. - **Carrier split** (`AS.4:4.1`): agent reads `references/`, human edits `assets/FPF-Spec.md` - **Full rebuild** on every change: copy monolith → decompose → update dispatcher - **Idempotent writes**: `decompose_fpf.py` skips unchanged files ## Evolution If the user is dissatisfied with the result or the FPF-Spec structure changes, offer to update this skill's script or its SKILL.md instructions.
Pliki w paczce (5)
- SKILL.md 3 KB
- scripts/_common.py 6 KB
- scripts/decompose_fpf.py 15 KB
- scripts/errors.py 1 KB
- scripts/sync_fpf_core.py 9 KB
Wersje
W bazie nie ma innych skilli o nazwie fpf-sync.
Migawka bazy z 13.11.2026 · wersja paczki 2665ecbbdbc7 (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
- 100fpf-library-sync
Buduje i odświeża zestaw skilli FPF z monolitów biblioteki Levenchuk FPF, w tym fpf-core i skille dpf-*, także jako zadanie cykliczne. - 85dpf-lfw-architecture
Porządkuje przestrzeń roboczą FPF, DPF i LPF: gdzie umieścić nowy framework, jak ustawić strukturę skill-carrier i jak rozstrzygać granice LPF i projektu. - 90source-command-wiki
Sprawdza, odpytuje i odświeża wiki wtyczki FPF, gdy użytkownik o to poprosi. - 100fpf-integration
Włącza do projektu First Principles Framework (FPF): audyt decyzji i jakości dowodów, mechanizm wygasania, kontrolę uprzedzeń poznawczych, listy kontrolne ról oraz audyt kontekstów i terminologii. - 90fpf-core
Dostarcza wzorce Frameworka Pierwszych Zasad dla inżynierii, badań, zarządzania i pracy ludzi z AI, ładując tylko potrzebne fragmenty. - 85episteme-compaction
Bezstratnie kompaktuje epistemy między prozą a zwięzłą notacją typowanych slotów, oszczędzając około 65 proc. tokenów, z odtworzeniem do źródła i zależnością od fpf-core.