Klimkit

v0.1.4 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 23d AI Agents & Assistants

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agent-workflows agentic-engineering ai-agents automation cli code-server

+8 more

codex codex-cli developer-tools proof-reports pwa python tailscale worktrees

Summary

AI summary

Added Reflection Gate requiring fresh‑context reflections before final review.

Full changelog

What changed

Added a standard Reflection Gate to the shared Codex harness: after verification and before final reviewers, non-trivial implementation work now runs fresh-context reflection, appends to .klimkit/reflection.md, and reconsiders the implementation, evidence, and final response before final review.
Added the new reflector subagent as a fresh-context synthesis keeper that reads the current task, wider .klimkit/tasks/ archive, .klimkit/log.md, and .klimkit/memory.md, then appends a dated reflection entry with source-read summary, synthesis, risks, contradictions, and candidate follow-ups.
Updated checklister so non-trivial implementation checklists include reflection intake/write checks and allow tiny one-command tasks to mark reflection explicitly not applicable.
Updated final_reviewer so final review requires the reflection entry or an explicit not-applicable note, and verifies material reflection findings were incorporated or deliberately deferred.
Updated shared AGENTS.md and the harness-tuning skill with the Reflection Gate, reflection templates, memory/log/reflection boundaries, and the no-hacks / fail-loud quality guidance from the prior rule integration.
Created Klimkit's first .klimkit/reflection.md ledger entry for this workflow and included task proof under .klimkit/tasks/03-reflection-workflow/.
Bumped package and README release metadata to 0.1.4.

Validation

3/3 final reviewers passed for the reflection workflow before release.
uv run python -m unittest tests.test_codex_pack_validation -q: 9 OK.
uv run python -m unittest tests.test_codex_pack_validation tests.test_docs_static -q: 13 OK.
uv run python -m unittest discover -s tests -q: 144 OK, 1 skipped.
git diff --check: passed.
kk apply projected the new harness files and created /home/ubuntu/.codex/agents/reflector.toml on ODev.

Upgrade note

Fork-first operators should merge this release into their operator repo, run kk pull or kk apply on each machine, and expect future non-trivial Codex work to include a reflection entry before final reviewers. Existing task histories remain valid; .klimkit/reflection.md is append-only and starts accumulating synthesis from this release onward.