clemvault internals alpha

Self-Improvement Module

A weekly meta-routine that scans the vault for coverage gaps, compares against external AI signals, and surfaces 5 ranked improvement candidates.

PythonTypeScriptOllamaYAMLWindows Task Scheduler

The vault executes patterns I already know. It doesn’t have a mechanism for questioning whether those patterns are still the right ones. New agent frameworks ship every week. Better approaches to context isolation, memory management, and cost control appear in the harness feed. Without a forcing function, those signals never enter the build queue.

The Problem

Systematic improvement requires systematic questioning. The vault is good at executing what’s been decided but bad at re-evaluating those decisions against new information. The gap between “what we’re building” and “what we could be building” grows wider without a weekly reset.

What It Is

A Monday morning routine that runs two scans in parallel: a vault coverage scan (POW debt, branch gaps, unactivated routines) and a news scan filtered to harness and agent tooling signals. The two are compared and ranked into 5 improvement suggestions, each tagged with source, affected branch, and effort estimate. Dismissed suggestions are logged and won’t re-surface for 30 days.

Features

Stack

ToolRole
Python / TypeScriptScan scripts
Ollama / ClaudeGap analysis and ranking
YAMLDismissal log
Windows Task SchedulerMonday morning trigger

Development timeline

2 logged updates over 3 days, 15 May 2026 to 17 May 2026.

  1. All three pieces landed on one dayfeature

    The scan, the ranking and the human gate were built together, which is why this project is further along than its sibling scaffolds.

  2. Scoped: a weekly reader that says what to fix nextfix

    The vault accumulates faster than anyone reviews it. The idea was a scheduled pass that reads the current build state, reads what has arrived from outside, and returns a ranked list of improvement candidates.

Written from this project's decision log as work happened, not afterwards. See every project →