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.
- Autor
- nrdxp ↗
- Repozytorium
- predicate ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 31.08.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 31.08.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 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
- Purpose
- Execution Protocol
- Output Format Guidelines
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · nrdxp/predicate | 100 | MIT |
| microsoft/vscode | 100 | MIT |
| alexander-tyagunov/magician | 100 | MIT |
| carlheath/ogmios | 100 | MIT |
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.