Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

chronicle

/chronicle

Utrzymuje i aktualizuje trwałą kronikę projektu w docs/chronicle.md, gdy ktoś prosi o podsumowanie historii albo zaczyna pracę nad nową bazą kodu i potrzebuje kontekstu jej ewolucji.

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

Brak sygnałów. Repozytorium zmienione 31.08.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ą
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/update_chronicle.py

Co robi i kiedy

Utrzymuje i aktualizuje trwałą kronikę projektu w docs/chronicle.md, gdy ktoś prosi o podsumowanie historii albo zaczyna pracę nad nową bazą kodu i potrzebuje kontekstu jej ewolucji.

Oryginalny opis (EN)

Maintain and update the persistent project chronicle (docs/chronicle.md). Trigger when: - The human requests a history summary or chronicle update. - Starting work on a new codebase and needing context on its evolution. - Prompt contains keywords: /chronicle, chronicle, project history, git log summary, history summary.

Jak działa

  1. Purpose
  2. Execution Protocol
  3. Output Format Guidelines
Sekcje z nagłówków SKILL.md, w oryginale · 59 linii, 443 słów
Podgląd SKILL.md
---
name: chronicle
description: |
  Maintain and update the persistent project chronicle (docs/chronicle.md).
  Trigger when:
  - The human requests a history summary or chronicle update.
  - Starting work on a new codebase and needing context on its evolution.
  - Prompt contains keywords: /chronicle, chronicle, project history, git log summary, history summary.
---

# Chronicle Workflow

A structured approach to maintaining a high-level, conceptual project chronicle (`docs/chronicle.md`). This chronicle serves as a persistent decision record, mapping the evolution of the codebase's architecture, workflows, and conventions to optimize agent context and human understanding.

---

## Purpose

Standard git logs are either too detailed or too fragmented to provide deep architectural context. The **Chronicle Workflow** maintains an incremental, high-level chronicle file in the repository. Because it uses a commit cutoff marker in its frontmatter, it can be updated cheaply and incrementally over time, serving as a durable project history journal.

---

## Execution Protocol

To update or initialize the chronicle, follow these steps:

### 1. Prepare Pending Logs
Run the helper script in prepare mode:
```bash
python3 skills/chronicle/scripts/update_chronicle.py --prepare
```

If the chronicle is already up to date, the script will output:
`Chronicle is already up to date with HEAD.` and you may exit.

Otherwise, it will output a batch of up to 50 commits (from oldest to newest) along with changed files. Note the `TARGET_END_SHA` printed at the end of the output — you pass it back to the write step so the recorded range is bound to exactly the commits you summarized (immune to HEAD moving in between).

### 2. Group and Summarize
Using your LLM reasoning, analyze the batch output. Group the commits into conceptual themes rather than listing them raw. Focus on **why** changes were made, what design decisions were reached, and major milestones.

Organize the summary into the following categories where relevant:
- **Architectural Shift / Design Decisions**: Major structural changes, folder reorganizations, and key trade-offs.
- **Workflow & Rulesets**: Updates to workflows, rulesets, and agent configurations.
- **Features & Implementation**: Core user-facing features and implementations.
- **Infrastructure & Quality**: CI, tooling, linting, and test configurations.
- **Documentation**: Significant documentation changes (beyond minor typos).

### 3. Commit the Update
Run the helper script in write mode, passing the `TARGET_END_SHA` from Step 1 and your structured Markdown summary:
```bash
python3 skills/chronicle/scripts/update_chronicle.py --write --end-sha <TARGET_END_SHA> --summary "<Markdown formatted summary>"
```

### 4. Repeat
If the write command output indicates remaining pending commits (e.g., `Remaining pending commits: N`), repeat from Step 1 until the prepare command reports that it is fully up to date.

---

## Output Format Guidelines

The chronicle summaries should be written in clean, concise Markdown. Avoid listing individual commit SHAs in the summary text (the headers already track the ranges). Example format:

```markdown
- **Architectural Shift**: Distilled global ruleset to align with axiom/persona conventions.
- **Workflow & Rulesets**: Formalized planning workflows by adding `SKETCH` and `PLAN` protocols.
- **Quality & Infrastructure**: Ignore cache files and standardize tooling in the root configuration.
```
Pliki w paczce (2)
  • SKILL.md 3 KB
  • scripts/update_chronicle.py 8 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · nrdxp/predicate100MIT
microsoft/vscode100MIT
alexander-tyagunov/magician100MIT
carlheath/ogmios100MIT

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

  • 86chronicle-graph
    Porządkuje graf wiedzy użytkownika tak, by węzły miały czytelne tytuły i zawierały to, co użytkownik faktycznie zrobił.
  • 100chronicle-context
    Opiera pracę na tym, co użytkownik robił na komputerze, zanim podejmie działania w aplikacjach lub przy kontynuacji zadania.
  • 100contextsutra-decision-chronicle
    Zestawia decyzje inżynierskie i ADR z zadeklarowanym statusem oraz wskazuje, które z nich czekają jeszcze na decyzję człowieka.
  • 100git-review
    Przegląda historię git pod kątem spójności zmian: analiza historii projektu, diffów i zgodności komunikatów commitów z celem.
  • 100fact-check
    Weryfikuje twierdzenia w tekstach, sprawdza źródła i wskazuje problemy ze stylem, samodzielnie lub po skillu chronicle.
  • 80vc:docs
    Analizuje bazę kodu i inicjuje, aktualizuje lub streszcza dokumentację projektu.

Uwagi i zgłoszenia

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