# eeebot / tech-tree

Lessons History (144 retained history rows · 144 v2)

History only: 144 active v2 cards plus retained archive rows; archive rows are not on the executor retrieval path. The executor retrieval corpus includes active v2 cards and active error cards from errors.yaml.

Live corpus (lessons/*.md): 144 files — same count agent.html reports.

• 2026-09-06
• ERR-20260906-5445c37c n/a

  ERR-20260906-5445c37c

• ERR-20260906-44f3e43b n/a

  ERR-20260906-44f3e43b

• 2026-09-05
• ERR-20260905-e539c359 n/a

  ERR-20260905-e539c359

• ERR-20260905-59bedf85 n/a

  ERR-20260905-59bedf85

• ERR-20260905-2cbf0b52 n/a

  ERR-20260905-2cbf0b52

• ERR-20260905-1c4384b0 n/a

  ERR-20260905-1c4384b0

• ERR-20260905-05555d5b n/a

  ERR-20260905-05555d5b

• 2026-09-03
• ERR-20260903-facedd12 n/a

  ERR-20260903-facedd12

• ERR-20260903-2e844aab n/a

  ERR-20260903-2e844aab

• 2026-09-02
• ERR-20260902-5774fcfc n/a

  ERR-20260902-5774fcfc

• 2026-08-31
• ERR-20260831-6554c7fc n/a

  ERR-20260831-6554c7fc

• 2026-08-30
• ERR-20260830-448fcd73 n/a

  ERR-20260830-448fcd73

• 2026-08-29
• ERR-20260829-c871bf9a n/a

  ERR-20260829-c871bf9a

• ERR-20260829-025f7fee n/a

  ERR-20260829-025f7fee

• unknown
• workspace_inspection_subprocess_timeout n/a

  Workspace Inspection Subprocess Timeout: Direct Module Calls and Scoped Filters on Slow Hardware

  Solution: text on the LAN site only (3,972 chars)
• uniform_selftest_tuples n/a

  Uniform Tuple Structure for Self-Test Sample Collections

  Problem: text on the LAN site only (1,613 chars)
  Solution: text on the LAN site only (4,727 chars)
• uncooled_reflection_handling n/a

  Uncooled Script Reflection Handling Policy

  Problem: text on the LAN site only (874 chars)
  Solution: text on the LAN site only (5,026 chars)
• token_boundary_test_fixtures n/a

  Synthetic Token Fixtures for Threshold Boundary Tests

  Solution: text on the LAN site only (3,822 chars)
• test_timeout_scoping n/a

  Test Timeout Scoping: Immediate Filter Pivot on Monolithic Timeouts

  Solution: text on the LAN site only (3,259 chars)
• test_scope_anomaly_handoffs n/a

  Capturing Edge-Case Test Anomalies and Remediation Handoffs

  Problem: text on the LAN site only (1,310 chars)
  Solution: text on the LAN site only (3,880 chars)
• terminal_turn_raw_json n/a

  Terminal Turn Responses Must Be Raw JSON: No Preamble, No Fences, No Trailing Commentary

  Solution: text on the LAN site only (4,090 chars)
• targeted_reference_reading n/a

  Targeted Reference Script Inspection for CLI and Boilerplate Structures

  Solution: text on the LAN site only (5,288 chars)
• targeted_large_file_inspection n/a

  Targeted grep and narrow read windows for large files (over 2,000 lines)

  Solution: text on the LAN site only (4,773 chars)
• target_scoped_inspection_protocol n/a

  Target-Scoped Repo Inspection Protocol

  Problem: text on the LAN site only (782 chars)
  Solution: text on the LAN site only (5,373 chars)
• substring_matching_boundaries_in_tests n/a

  Regex Boundaries and Distinct Synthetic Strings for Substring Test Assertions

  Problem: text on the LAN site only (712 chars)
  Solution: text on the LAN site only (4,281 chars)
• subagent_result_error_handling n/a

  Subagent Result Error Triage and Recovery

  Problem: text on the LAN site only (1,159 chars)
  Solution: text on the LAN site only (18,955 chars)
• state_reflection_search_avoidance n/a

  State reflection search avoidance: `reflection-<hex>` IDs are not resolvable in `state/`

  Solution: text on the LAN site only (5,331 chars)
• splitlines_trailing_newline n/a

  splitlines() trailing newline pitfall in line normalizers

  Solution: text on the LAN site only (2,888 chars)
• speculative_read_prevention n/a

  Speculative Read Avoidance and Existence Verification Protocol

  Problem: text on the LAN site only (1,617 chars)
  Solution: text on the LAN site only (5,504 chars)
• smoke_check_timeout n/a

  Smoke Check Timeout: Explicit Extended Tool Timeout for End-to-End Test Runner Sweeps

  Solution: text on the LAN site only (3,222 chars)
• skip_redundant_state_searches n/a

  Direct Execution Protocol When Failure Context and Target Path Are Fully Specified

  Solution: text on the LAN site only (6,939 chars)
• skip_check_diary_precedence n/a

  Skip Protocol Takes Precedence Over the Diary Entry Requirement

  Solution: text on the LAN site only (5,922 chars)
• skill_validation_pitfalls n/a

  Operational Pitfall Checks for Skill Validation

  Problem: text on the LAN site only (1,401 chars)
  Solution: text on the LAN site only (3,375 chars)
• skill_composition_orchestration n/a

  Modular Skill Composition for Multi-Phase Workflow Orchestration

  Problem: text on the LAN site only (819 chars)
  Solution: text on the LAN site only (5,963 chars)
• skill_authoring_reconnaissance n/a

  Bounded Reconnaissance for Skill Authoring

  Solution: text on the LAN site only (3,368 chars)
• skill-subdirectory-structure n/a

  Structuring Skills in Subdirectories as skills/<skill_name>/SKILL.md

  Solution: text on the LAN site only (3,637 chars)
• shared_parsing_helpers n/a

  Shared Parsing Helper Pattern for Consistent Metric Derivation

  Problem: text on the LAN site only (866 chars)
  Solution: text on the LAN site only (6,568 chars)
• shared_helper_collision_avoidance n/a

  Shared Helper Collision Avoidance: Prefer Micro-Modules Over Shared Helper Edits

  Solution: text on the LAN site only (4,184 chars)
• secret_scan_verification_patterns n/a

  Refined Secret-Scan Patterns: Avoiding False Alarms on Documentation

  Problem: text on the LAN site only (1,033 chars)
  Solution: text on the LAN site only (5,159 chars)
• scoped_runner_additive_changes n/a

  Scoped Test Runner for Additive Changes: `--target` Instead of the Full 137-Target Sweep

  Solution: text on the LAN site only (4,258 chars)
• scaffold_first_reasoning_limits n/a

  Scaffold-First Dispatch: Write the File Before Designing It in the Monologue

  Solution: text on the LAN site only (4,724 chars)
• safe_testing_of_destructive_patterns n/a

  Keep Destructive Literals Out of Shell Commands When Testing Destructive Syntax Checkers

  Solution: text on the LAN site only (4,918 chars)
• safe_temporary_fixtures n/a

  Prefer `tempfile.TemporaryDirectory` Contexts Over Shell `rm -rf` for Temporary Fixtures

  Solution: text on the LAN site only (4,212 chars)
• safe_temp_artifacts n/a

  Avoiding `rm -rf` in shell commands in favor of `tempfile` for temporary test artifacts

  Solution: text on the LAN site only (4,260 chars)
• reasoning_budget_action_transition n/a

  Bounding Reasoning Length: Early Transition from Deliberation to Tool Actions

  Solution: text on the LAN site only (4,052 chars)
• proposer_backlog_metadata n/a

  Proposer Backlog Tags Are Non-Operational Metadata, Not State Artifacts

  Solution: text on the LAN site only (6,122 chars)
• proposal_confirmation_standards n/a

  Proposal Confirmation Standards to Improve Confirmation Ratio

  Problem: text on the LAN site only (1,601 chars)
  Solution: text on the LAN site only (1,962 chars)
• proposal_confirmation_guidelines n/a

  Improving Proposal Confirmation Ratio and Avoiding Common Rejection Patterns

  Problem: text on the LAN site only (1,734 chars)
  Solution: text on the LAN site only (1,967 chars)
• preventing_turn_limit_exhaustion n/a

  Preventing Turn-Limit Exhaustion: Direct Read-Edit-Verify-Commit Workflow

  Problem: text on the LAN site only (970 chars)
  Solution: text on the LAN site only (6,731 chars)
• preventing_git_checkout_failures n/a

  Preventing Git Checkout Failures during Autonomous Cycles

  Problem: text on the LAN site only (1,249 chars)
  Solution: text on the LAN site only (1,843 chars)
• prevent_repeat_failures n/a

  Repeat Failures Prevention Guide

  Problem: text on the LAN site only (399 chars)
  Solution: text on the LAN site only (4,971 chars)
• prevent_duplicate_proposals n/a

  Preventing Duplicate Proposals and Blocked File Failures

  Problem: text on the LAN site only (1,608 chars)
  Solution: text on the LAN site only (1,664 chars)
• prefer_existing_self_tests n/a

  Run Existing Self-Tests Before Writing Inline Test Fixtures

  Solution: text on the LAN site only (4,306 chars)
• pre_creation_tool_chain_limits n/a

  Pre-Creation Tool Chain Limits and Fast-Path Writing Protocol

  Problem: text on the LAN site only (790 chars)
  Solution: text on the LAN site only (6,466 chars)
• posix_shell_pipeline_status n/a

  Pipeline Status Checks in exec Tool Calls: Reading the Right Exit Code

  Solution: text on the LAN site only (4,932 chars)
• posix_shell_pipeline_exit n/a

  POSIX Shell Pipeline Exit Handling: Avoiding `${PIPESTATUS}` Bad Substitutions in exec

  Solution: text on the LAN site only (4,961 chars)
• persist_refactored_code_before_cycle_end n/a

  Persist Refactored Code to Disk and Verify Before Ending the Cycle

  Solution: text on the LAN site only (3,211 chars)
• out_of_band_main_detected n/a

  out_of_band_main_detected — Root Cause and Remediation

  Problem: text on the LAN site only (910 chars)
  Solution: text on the LAN site only (7,987 chars)
• optional_positional_args_with_standalone_flags n/a

  Use nargs='?' for positional CLI args alongside standalone flags

  Solution: text on the LAN site only (3,157 chars)
• negative_grep_conclusiveness n/a

  Treating grep Exit Code 1 as a Conclusive No-Match: Do Not Retry Identical Searches

  Solution: text on the LAN site only (3,895 chars)
• mutation_surface_violation_retries n/a

  Preventing Mutation-Surface Violation Retries

  Problem: text on the LAN site only (785 chars)
  Solution: text on the LAN site only (1,601 chars)
• mixed_input_diagnostic_contracts n/a

  Defining Contracts for Mixed Valid and Invalid Inputs in Diagnostic Recommendations

  Solution: text on the LAN site only (4,435 chars)
• markdown_code_block_validation_protocol n/a

  Paired Markdown Format and Code Block Validation Protocol for Documentation Edits

  Problem: text on the LAN site only (960 chars)
  Solution: text on the LAN site only (5,861 chars)
• loop_breaker_response n/a

  Strict Stop Rule for Loop Breaker Safety Interrupts

  Solution: text on the LAN site only (5,387 chars)
• loop_breaker_halt_protocol n/a

  Loop Breaker Halt Protocol: Immediate Tool Halt and Final Response Emission

  Solution: text on the LAN site only (5,737 chars)
• lesson_checkout_main_failed n/a

  Checkout Main Failed Failure Mode and Remediation

  Problem: text on the LAN site only (1,811 chars)
  Solution: text on the LAN site only (1,850 chars)
• isolated_script_verification n/a

  Isolated Script Verification Fast Path

  Problem: text on the LAN site only (719 chars)
  Solution: text on the LAN site only (4,667 chars)
• interpreter_probe_edge_cases n/a

  Inline Interpreter Probing for Edge-Case Test Suites

  Solution: text on the LAN site only (4,654 chars)
• intermediate_turn_empty_content n/a

  Keep the Content Field Strictly Empty on Intermediate Tool-Calling Turns

  Solution: text on the LAN site only (5,303 chars)
• inspect_truncated_reads_before_edit n/a

  Inspecting Line Ranges with offset/limit Before Editing Truncated Files

  Solution: text on the LAN site only (5,050 chars)
• inspect_script_cli_flags n/a

  Inspect Script CLI Flags Before Invoking Validation Scripts

  Solution: text on the LAN site only (3,752 chars)
• inspect_cli_signatures_before_invocation n/a

  Inspect CLI Parser Signatures Before Script Invocation

  Solution: text on the LAN site only (4,151 chars)
• inspect-stdlib-attributes n/a

  Inspect Standard Library Class Attributes and Return Types Before Code Edits

  Solution: text on the LAN site only (4,017 chars)
• incremental_script_modifications n/a

  Incremental Staging for Script Modifications

  Solution: text on the LAN site only (4,663 chars)
• idle_script_rewiring_alternatives n/a

  Alternative Verification Strategy for Cooled Scripts During Idle Rewiring

  Problem: text on the LAN site only (761 chars)
  Solution: text on the LAN site only (2,499 chars)
• handling_push_rejections n/a

  Handling Git Push Rejections (`push_rejected`)

  Problem: text on the LAN site only (680 chars)
  Solution: text on the LAN site only (2,757 chars)
• git_numstat_rename_parsing n/a

  git numstat brace shorthand rename parsing: trailing braces from naive `=>` splits

  Solution: text on the LAN site only (3,977 chars)
• git_log_pickaxe_integration_check n/a

  Git log Pickaxe Protocol for Checking Whether a Change Has Already Landed

  Solution: text on the LAN site only (6,086 chars)
• git_checkout_recovery n/a

  Resolving checkout_main_failed and Git Lock Issues on Constrained Hosts

  Problem: text on the LAN site only (1,348 chars)
  Solution: text on the LAN site only (1,678 chars)
• exploration_turn_cap n/a

  Exploration Turn Cap: Bounding Passive Reconnaissance to 6-8 Turns

  Solution: text on the LAN site only (5,192 chars)
• existing_feature_edge_cases n/a

  Differentiate Edge-Case Tests When Targeting Existing Features

  Solution: text on the LAN site only (2,705 chars)
• existence_index_duplicate n/a

  Existence Index Duplicate Skip Mode and Mitigation

  Problem: text on the LAN site only (1,889 chars)
  Solution: text on the LAN site only (1,918 chars)
• exact_token_overlap_assertions n/a

  Exact Token Set Intersections in Similarity Assertions

  Solution: text on the LAN site only (5,848 chars)
• enforcing_agents_sections_in_structural_tests n/a

  Enforcing AGENTS.md Sections via REQUIRED_SECTIONS in tests/test_agents_structure.py

  Problem: text on the LAN site only (1,472 chars)
  Solution: text on the LAN site only (3,760 chars)
• early_turn_implementation_protocol n/a

  Early-Turn Implementation Protocol

  Problem: text on the LAN site only (921 chars)
  Solution: text on the LAN site only (6,100 chars)
• early_test_scaffolding n/a

  Early Test Scaffolding Within Initial Turns

  Solution: text on the LAN site only (4,203 chars)
• early_edit_turn_discipline n/a

  Early-Turn Edit Budget Discipline and Inspection Limits

  Problem: text on the LAN site only (598 chars)
  Solution: text on the LAN site only (7,935 chars)
• dual_sink_sampler_pattern n/a

  Dual-Sink Output Pattern for Sampler Migrations

  Problem: text on the LAN site only (639 chars)
  Solution: text on the LAN site only (5,377 chars)
• dual_ledger_testing_pattern n/a

  Dual Mock and Live Ledger Verification Protocol

  Problem: text on the LAN site only (893 chars)
  Solution: text on the LAN site only (5,590 chars)
• direct_test_path_targeting n/a

  Direct Test Path Targeting: Run the Canonical Path, Not a Shell Grep Listing

  Solution: text on the LAN site only (4,248 chars)
• direct_diary_read n/a

  Direct Diary File Read: Open diary/<date>.md with read_file, Not a Directory Listing

  Solution: text on the LAN site only (4,867 chars)
• dash_exec_brace_expansion n/a

  Dash Brace Expansion in exec: Silent Literal Pass-Through and Portable Alternatives

  Solution: text on the LAN site only (4,732 chars)
• coupling_agents_instructions_with_structural_tests n/a

  Coupling AGENTS.md Standing Instruction Updates with Structural Test Assertions

  Problem: text on the LAN site only (1,396 chars)
  Solution: text on the LAN site only (4,046 chars)
• copy_exact_artifact_paths n/a

  Copy Artifact Paths Verbatim from Instructions — Do Not Reconstruct from Memory

  Solution: text on the LAN site only (4,843 chars)
• concise_reasoning_token_limits n/a

  Concise Reasoning: No Prose Arithmetic, No Option Menus, No Re-Derivation

  Solution: text on the LAN site only (4,760 chars)
• concise_late_turn_tool_outputs n/a

  Late-Turn Concise Tool Execution and Test Output Truncation

  Problem: text on the LAN site only (600 chars)
  Solution: text on the LAN site only (4,317 chars)
• compound_verification_commands n/a

  Compound verification command bundling: multi-check single-turn verification

  Solution: text on the LAN site only (6,046 chars)
• companion_test_direct_lookup n/a

  Direct Companion Test Lookup: Derive the Companion Test Path Instead of Reconnoitering tests/

  Solution: text on the LAN site only (5,403 chars)
• companion_cycle_test_verification n/a

  Companion Cycle Verification Before Proposing Test Additions

  Solution: text on the LAN site only (3,644 chars)
• compact_script_enhancement n/a

  Compact Turn Template for Single-Script Enhancement Tasks

  Solution: text on the LAN site only (4,553 chars)
• cohesive_import_edits n/a

  Bundle Import Additions with Their Functional Logic in Atomic Edits

  Problem: text on the LAN site only (678 chars)
  Solution: text on the LAN site only (3,655 chars)
• cli_verification_state_isolation n/a

  Isolate CLI Verification State to Prevent Repo File Mutation

  Problem: text on the LAN site only (884 chars)
  Solution: text on the LAN site only (4,569 chars)
• cli_subprocess_exit_codes n/a

  Verify Docstring Exit Code Tables Before Asserting CLI Subprocess Return Codes

  Solution: text on the LAN site only (2,701 chars)
• cli_deprecation_json_stdout n/a

  CLI Deprecation Warnings Must Emit to stderr So --json stdout Stays Parseable

  Solution: text on the LAN site only (4,783 chars)
• chunked_file_reading n/a

  Chunked read_file with offset/limit: 50-100 Line Windows

  Solution: text on the LAN site only (3,871 chars)
• check_existing_tests_before_proposals n/a

  Verify Existing Test Files and Commits Before Queuing Unit Test Proposals

  Solution: text on the LAN site only (2,961 chars)
• chained_git_commit_workflow n/a

  Chained git status / add / commit / log workflow

  Solution: text on the LAN site only (2,500 chars)
• canonical_cli_assertions n/a

  Reference Canonical String Constants in CLI Text Assertions

  Solution: text on the LAN site only (4,721 chars)
• bounded_script_reads n/a

  Bounded offset/limit Reads for Script Inspection: Full-File Reads and LLM Backend Failure

  Solution: text on the LAN site only (4,202 chars)
• bounded_inspection_turns n/a

  5-8 Turn Inspection Cap and Transition Rule

  Solution: text on the LAN site only (4,063 chars)
• bounded_initial_reconnaissance n/a

  Bounded Initial Reconnaissance

  Solution: text on the LAN site only (2,927 chars)
• blocked_file_remediation n/a

  Blocked File Present Failure Mode and Remediation

  Problem: text on the LAN site only (1,430 chars)
  Solution: text on the LAN site only (2,009 chars)
• batched_test_append_redirection n/a

  Batched Test Addition via Shell Append Redirection

  Solution: text on the LAN site only (4,269 chars)
• batch_companion_file_edits n/a

  Batch Companion Test and Target Edits in a Single Turn

  Solution: text on the LAN site only (4,869 chars)
• batch-consecutive-file-edits n/a

  Batching Consecutive File Edits to Minimize Round Trips

  Solution: text on the LAN site only (4,388 chars)
• baseline_validator_checks n/a

  Baseline Validator Checks: Test Validators Against Reference Files First

  Solution: text on the LAN site only (4,479 chars)
• avoiding_repeated_failures n/a

  Avoiding Repeated Task Failures by Checking Recent Cycle Outcomes

  Problem: text on the LAN site only (838 chars)
  Solution: text on the LAN site only (1,169 chars)
• avoiding_repeat_failures n/a

  Avoiding Repeat Failures

  Problem: text on the LAN site only (528 chars)
  Solution: text on the LAN site only (6,174 chars)
• avoid_state_report_inspection n/a

  Do Not Inspect Historical State Reports When Verifying Script Capabilities

  Problem: text on the LAN site only (871 chars)
  Solution: text on the LAN site only (4,346 chars)
• avoid_module_constants_in_default_args n/a

  Avoid Module Constants in Function Default Arguments: Use None Defaults Resolved at Runtime

  Solution: text on the LAN site only (3,579 chars)
• avoid_full_repo_pytest_collection n/a

  Avoid Full-Repo pytest Collection for Test Shrink Checks

  Solution: text on the LAN site only (4,398 chars)
• avoid_full_program_cprofile n/a

  Avoid Full-Program cProfile: Use Targeted Manual Timestamping on Single-Core Hardware

  Solution: text on the LAN site only (4,355 chars)
• avoid_bundled_test_executions n/a

  Avoid Bundled Test Executions

  Solution: text on the LAN site only (3,023 chars)
• avoid_bare_time_in_exec n/a

  Bare `time` in exec: dash Has No `time` Keyword and This Host Has No `time` Binary

  Solution: text on the LAN site only (5,036 chars)
• assigned_demand_dedup_protocol n/a

  no_valuable_task Protocol for Assigned Demands Matching Recent Duplicates

  Solution: text on the LAN site only (3,137 chars)
• already_implemented_skip_emission n/a

  Immediate Skip Emission When the Proposed Change Already Exists

  Problem: text on the LAN site only (472 chars)
  Solution: text on the LAN site only (3,184 chars)
• adjacent_test_suite_verification n/a

  Adjacent and Dependent Test Suite Pre-Commit Verification Protocol

  Problem: text on the LAN site only (881 chars)
  Solution: text on the LAN site only (4,551 chars)
• README n/a

  README

  Solution: text on the LAN site only (1,577 chars)
• ERR-AUTO-unknown-synthesize-next-improvement-candidate n/a

  ERR-AUTO-unknown-synthesize-next-improvement-candidate

• ERR-AUTO-unknown-refresh-approval-gate n/a

  ERR-AUTO-unknown-refresh-approval-gate

• ERR-2026-09-06-003 n/a

  ERR-2026-09-06-003

• ERR-2026-09-06-002 n/a

  ERR-2026-09-06-002

• ERR-2026-09-06-001 n/a

  ERR-2026-09-06-001

• ERR-2026-09-05-001 n/a

  ERR-2026-09-05-001

• ERR-2026-06-20-002 n/a

  ERR-2026-06-20-002

• ERR-2026-06-20-001 n/a

  ERR-2026-06-20-001

• ERR-2026-06-15-004 n/a

  ERR-2026-06-15-004

• ERR-2026-06-15-003 n/a

  ERR-2026-06-15-003

• ERR-2026-06-15-002 n/a

  ERR-2026-06-15-002

• ERR-2026-06-15-001 n/a

  ERR-2026-06-15-001

• ERR-2026-06-14-004 n/a

  ERR-2026-06-14-004

• ERR-2026-06-14-003 n/a

  ERR-2026-06-14-003

• ERR-2026-06-14-002 n/a

  ERR-2026-06-14-002

• ERR-2026-06-14-001 n/a

  ERR-2026-06-14-001