Imprint window and bootstrap calibration for brain-modeled agentic AI. Manages the agent's initial learning period with an accelerated consolidation multiplier and three-phase learning architecture.
lex-coldstart implements the agent's bootstrap sequence. When an agent is first instantiated, it enters an imprint window (7 days by default) during which memory consolidation is tripled and consent is held at the conservative :consult tier. After the imprint window, the agent transitions to continuous learning.
| Phase | Description |
|---|---|
firmware |
Hardcoded values loaded before any observations |
imprint_window |
First 7 days — accelerated learning (3x multiplier) |
continuous_learning |
Post-imprint — normal operation |
| Parameter | Value | Description |
|---|---|---|
| Imprint duration | 7 days | Length of the imprint window |
| Imprint multiplier | 3.0x | Memory consolidation boost during imprint |
| Consent tier during imprint | :consult |
Conservative — always ask before acting |
| Entropy baseline | 50 observations | Minimum before entropy is meaningful |
| Self-play iterations | 100 | Bootstrap trace generation count |
Add to your Gemfile:
gem 'lex-coldstart'require 'legion/extensions/coldstart'
# Load firmware and begin imprint window
result = Legion::Extensions::Coldstart::Runners::Coldstart.begin_imprint
# => { started: true, imprint_duration: 604800,
# multiplier: 3.0, consent_tier: :consult }# Record that an observation occurred (increments counter toward entropy baseline)
Legion::Extensions::Coldstart::Runners::Coldstart.record_observation
# => { observation_count: 1, calibration_state: :imprinting, current_layer: :imprint_window }# Is the imprint window still active?
Legion::Extensions::Coldstart::Runners::Coldstart.imprint_active?
# => { active: true }
# Get the current learning multiplier
Legion::Extensions::Coldstart::Runners::Coldstart.current_multiplier
# => { multiplier: 3.0, imprint_active: true }
# Full progress report
Legion::Extensions::Coldstart::Runners::Coldstart.coldstart_progress
# => { firmware_loaded: true, imprint_active: true,
# imprint_progress: 0.14, observation_count: 7,
# calibration_state: :imprinting, current_layer: :imprint_window }| State | Condition |
|---|---|
:not_started |
Before begin_imprint |
:imprinting |
During imprint window |
:baseline_established |
>= 50 observations, imprint still active |
:calibrated |
>= 50 observations, imprint window expired |
lex-coldstart includes a parser and ingest runner for bridging Claude Code's auto-memory (MEMORY.md) and project CLAUDE.md files into the agent's lex-memory trace store. This is the primary bootstrap mechanism for seeding an agent's long-term memory from existing documentation.
# Ingest a single file
Legion::Extensions::Coldstart::Runners::Ingest.ingest_file(
file_path: '/Users/me/.claude/projects/myproject/MEMORY.md'
)
# => { file: '...', file_type: :memory, traces_parsed: 133, traces_stored: 133, traces: [...] }
# Ingest a full CLAUDE.md directory tree (recursive)
Legion::Extensions::Coldstart::Runners::Ingest.ingest_directory(
dir_path: '/Users/me/rubymine/legion'
)
# => { directory: '...', files_found: 66, total_parsed: 1546, total_stored: 1546, files: [...] }
# Preview without storing
Legion::Extensions::Coldstart::Runners::Ingest.preview_ingest(
file_path: '/Users/me/rubymine/legion/CLAUDE.md'
)
# => { file: '...', file_type: :claude_md, traces: [...] }Trace types are assigned from section headings: "Hard Rules"/"firmware" sections become :firmware traces (never decay), gotcha sections become :procedural, architecture sections become :semantic.
After ingestion, traces from the same markdown section are co-activated to seed Hebbian associative links. During the imprint window, ingested traces automatically receive the 3x reinforcement multiplier.
bundle install
bundle exec rspec
bundle exec rubocopMIT