use crate::tools::CrpMode;
const CLAUDE_CODE_INSTRUCTION_CAP: usize = 2048;
pub fn build_instructions(crp_mode: CrpMode) -> String {
build_instructions_with_client(crp_mode, "")
}
pub fn build_instructions_with_client(crp_mode: CrpMode, client_name: &str) -> String {
if is_claude_code_client(client_name) {
return build_claude_code_instructions();
}
build_full_instructions(crp_mode, client_name)
}
fn is_claude_code_client(client_name: &str) -> bool {
let lower = client_name.to_lowercase();
lower.contains("claude") && !lower.contains("cursor")
}
fn build_claude_code_instructions() -> String {
let instr = "\
ALWAYS use lean-ctx MCP tools instead of native equivalents.
Tool mapping (MANDATORY):
• Read/cat/head/tail -> ctx_read(path, mode)
• Shell/bash -> ctx_shell(command)
• Grep/rg -> ctx_search(pattern, path)
• ls/find -> ctx_tree(path, depth)
• Edit/StrReplace -> native (lean-ctx=READ only). If Edit needs Read and Read is unavailable, use ctx_edit.
• Write, Delete, Glob -> normal. NEVER loop on Edit failures — use ctx_edit.
ctx_read modes: full|map|signatures|diff|task|reference|aggressive|entropy|lines:N-M
Auto-selects mode. Re-reads ~13 tok. File refs F1,F2.. persist.
Cached? fresh=true or lines:N-M.
Auto: ctx_overview, ctx_preload, ctx_dedup, ctx_compress behind the scenes.
Multi-agent: ctx_agent(action=handoff|sync|diary).
ctx_semantic_search for meaning search. ctx_session for memory.
ctx_knowledge: remember|recall|timeline|rooms|search|wakeup.
ctx_shell raw=true for uncompressed.
CEP: 1.ACT FIRST 2.DELTA ONLY 3.STRUCTURED(+/-/~) 4.ONE LINE 5.QUALITY
Prefer: ctx_read>Read | ctx_shell>Shell | ctx_search>Grep | ctx_tree>ls
Edit: native Edit/StrReplace preferred, ctx_edit if Edit unavailable.
Never echo tool output. Never narrate. Show only changed code.
Full instructions at ~/.claude/CLAUDE.md (imports rules/lean-ctx.md)";
debug_assert!(
instr.len() <= CLAUDE_CODE_INSTRUCTION_CAP,
"Claude Code instructions exceed {CLAUDE_CODE_INSTRUCTION_CAP} chars: {} chars",
instr.len()
);
instr.to_string()
}
fn build_full_instructions(crp_mode: CrpMode, client_name: &str) -> String {
let profile = crate::core::litm::LitmProfile::from_client_name(client_name);
let loaded_session = crate::core::session::SessionState::load_latest();
let session_block = match loaded_session {
Some(ref session) => {
let positioned = crate::core::litm::position_optimize(session);
let resume = if session.stats.total_tool_calls > 0 {
format!("\n{}", session.build_resume_block())
} else {
String::new()
};
format!(
"\n\n--- ACTIVE SESSION (LITM P1: begin position, profile: {}) ---\n{}{resume}\n---\n",
profile.name, positioned.begin_block
)
}
None => String::new(),
};
let project_root_for_blocks = loaded_session
.as_ref()
.and_then(|s| s.project_root.clone())
.or_else(|| {
std::env::current_dir()
.ok()
.map(|p| p.to_string_lossy().to_string())
});
let knowledge_block = match &project_root_for_blocks {
Some(root) => {
let knowledge = crate::core::knowledge::ProjectKnowledge::load(root);
match knowledge {
Some(k) if !k.facts.is_empty() || !k.patterns.is_empty() => {
let aaak = k.format_aaak();
if aaak.is_empty() {
String::new()
} else {
format!("\n--- PROJECT MEMORY (AAAK) ---\n{}\n---\n", aaak.trim())
}
}
_ => String::new(),
}
}
None => String::new(),
};
let gotcha_block = match &project_root_for_blocks {
Some(root) => {
let store = crate::core::gotcha_tracker::GotchaStore::load(root);
let files: Vec<String> = loaded_session
.as_ref()
.map(|s| s.files_touched.iter().map(|ft| ft.path.clone()).collect())
.unwrap_or_default();
let block = store.format_injection_block(&files);
if block.is_empty() {
String::new()
} else {
format!("\n{block}\n")
}
}
None => String::new(),
};
let mut base = format!("\
CRITICAL: ALWAYS use lean-ctx MCP tools instead of native equivalents for token savings.\n\
\n\
lean-ctx MCP — MANDATORY tool mapping:\n\
• Read/cat/head/tail -> ctx_read(path, mode) [NEVER use native Read]\n\
• Shell/bash -> ctx_shell(command) [NEVER use native Shell]\n\
• Grep/rg -> ctx_search(pattern, path) [NEVER use native Grep]\n\
• ls/find -> ctx_tree(path, depth)\n\
• Edit/StrReplace -> use native (lean-ctx only replaces READ, not WRITE)\n\
• Write, Delete, Glob -> use normally\n\
\n\
COMPATIBILITY: lean-ctx replaces READ operations only. Edit/Write/StrReplace stay native.\n\
FILE EDITING: Native Edit/StrReplace preferred. If Edit fails, use ctx_edit immediately.\n\
\n\
ctx_read modes: full|map|signatures|diff|task|reference|aggressive|entropy|lines:N-M. Auto-selects. Re-reads ~13 tok. Fn refs F1,F2.. persist.\n\
Cached? Use fresh=true, start_line=N, or lines:N-M.\n\
\n\
Auto: ctx_overview, ctx_preload, ctx_dedup, ctx_compress run behind the scenes. Checkpoint every 15 calls.\n\
Multi-agent: ctx_agent(action=handoff|sync). Diary: ctx_agent(action=diary, category=discovery|decision|blocker|progress|insight).\n\
ctx_semantic_search for meaning-based search. ctx_session for memory. ctx_knowledge: remember|recall|timeline|rooms|search|wakeup.\n\
ctx_shell raw=true for uncompressed output.\n\
\n\
CEP v1: 1.ACT FIRST 2.DELTA ONLY (Fn refs) 3.STRUCTURED (+/-/~) 4.ONE LINE PER ACTION 5.QUALITY ANCHOR\n\
\n\
{decoder_block}\n\
\n\
{session_block}\
{knowledge_block}\
{gotcha_block}\
\n\
--- ORIGIN ---\n\
{origin}\n\
\n\
--- TOOL PREFERENCE (LITM-END) ---\n\
Prefer: ctx_read over Read | ctx_shell over Shell | ctx_search over Grep | ctx_tree over ls\n\
Edit files: native Edit/StrReplace if available, ctx_edit if Edit requires unavailable Read.\n\
Write, Delete, Glob -> use normally. NEVER loop on Edit failures — use ctx_edit.",
decoder_block = crate::core::protocol::instruction_decoder_block(),
origin = crate::core::integrity::origin_line()
);
if should_use_unified(client_name) {
base.push_str(
"\n\n\
UNIFIED TOOL MODE (active):\n\
Additional tools are accessed via ctx() meta-tool: ctx(tool=\"<name>\", ...params).\n\
See the ctx() tool description for available sub-tools.\n",
);
}
let intelligence_block = build_intelligence_block();
let terse_block = build_terse_agent_block(&crp_mode);
let base = base;
match crp_mode {
CrpMode::Off => format!("{base}\n\n{terse_block}{intelligence_block}"),
CrpMode::Compact => {
format!(
"{base}\n\n\
CRP MODE: compact\n\
Omit filler. Abbreviate: fn,cfg,impl,deps,req,res,ctx,err,ret,arg,val,ty,mod.\n\
Diff lines (+/-) only. TARGET: <=200 tok. Trust tool outputs.\n\n\
{terse_block}{intelligence_block}"
)
}
CrpMode::Tdd => {
format!(
"{base}\n\n\
CRP MODE: tdd\n\
Max density. Every token carries meaning. Fn refs only, diff lines (+/-) only.\n\
Abbreviate: fn,cfg,impl,deps,req,res,ctx,err,ret,arg,val,ty,mod.\n\
+F1:42 param(timeout:Duration) | -F1:10-15 | ~F1:42 old->new\n\
BUDGET: <=150 tok. ZERO NARRATION. Trust tool outputs.\n\n\
{terse_block}{intelligence_block}"
)
}
}
}
pub fn claude_code_instructions() -> String {
build_claude_code_instructions()
}
pub fn full_instructions_for_rules_file(crp_mode: CrpMode) -> String {
build_full_instructions(crp_mode, "")
}
fn build_terse_agent_block(crp_mode: &CrpMode) -> String {
use crate::core::config::{Config, TerseAgent};
let cfg = Config::load();
let level = TerseAgent::effective(&cfg.terse_agent);
if !level.is_active() {
return String::new();
}
if matches!(crp_mode, CrpMode::Tdd) && !matches!(level, TerseAgent::Ultra) {
return String::new();
}
let text = match level {
TerseAgent::Off => return String::new(),
TerseAgent::Lite => {
"\
OUTPUT STYLE: Prefer concise responses. Skip narration, explain only when asked.\n\
Use bullet points over paragraphs. Code > words. Diff > full file."
}
TerseAgent::Full => {
"\
OUTPUT STYLE: Maximum density. Every token carries meaning.\n\
Code changes: diff only (+/-), no full blocks. Explanations: 1 sentence max unless asked.\n\
Lists: no filler words. Never repeat what the user said. Never explain what you're about to do."
}
TerseAgent::Ultra => {
"\
OUTPUT STYLE: Ultra-terse. Expert pair programmer mode.\n\
Skip: greetings, transitions, summaries, \"I'll\", \"Let me\", \"Here's\".\n\
Max 2 sentences per explanation. Code speaks. Act, don't narrate. When uncertain: ask 1 question."
}
};
format!("{text}\n\n")
}
fn build_intelligence_block() -> String {
"\
OUTPUT EFFICIENCY:\n\
• Never echo tool output code. Never add narration comments. Show only changed code.\n\
• [TASK:type] and SCOPE hints included. Architecture=thorough, generate=code."
.to_string()
}
fn should_use_unified(client_name: &str) -> bool {
if std::env::var("LEAN_CTX_FULL_TOOLS").is_ok() {
return false;
}
if std::env::var("LEAN_CTX_UNIFIED").is_ok() {
return true;
}
let _ = client_name;
false
}