jerpint / jerpint/woltspace

Faster boot: reduce start-chat file reads

Open
#283 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
12
Forks
1
Avg merge
7h 13m
Merged PRs (30d)
31

Description

Problem

start-chat reads 5 files before the wolt says anything: mode file + identity.md + context.md + learnings.md + CLAUDE.md. With bloated context files this takes multiple chunked reads and delays first response significantly.

Proposal

Read only identity.md + context.md at boot (the minimum to know who you are and what's active). Load learnings.md on-demand when the wolt needs reference material. CLAUDE.md is already loaded by Claude Code automatically — start-chat doesn't need to read it again.

Cuts boot reads from 5 to 3 (mode + identity + context).

Related

  • Part of broader context management initiative
  • Connects to #284 (create-wolt split) and #285 (boot file size budget)

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the start-chat entry point and trace its boot-time reads of the mode file, identity.md, context.md, learnings.md, and CLAUDE.md. Confirm which files are currently read before the first response, then verify that boot reads only mode, identity.md, and context.md while learnings.md is deferred and CLAUDE.md is not reread.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
cli
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.