Skip to content

docs: add chapters 04-06 (AI core series)#6

Merged
luyao618 merged 1 commit into
mainfrom
docs/add-chapters-04-05-06
Apr 2, 2026
Merged

docs: add chapters 04-06 (AI core series)#6
luyao618 merged 1 commit into
mainfrom
docs/add-chapters-04-05-06

Conversation

@luyao618
Copy link
Copy Markdown
Owner

@luyao618 luyao618 commented Apr 2, 2026

Summary

  • Chapter 04: System Prompt Engineering — two-phase prompt assembly (static/dynamic boundary), section caching system, 4-block cache splitting, internal vs external variants, prompt priority hierarchy, fork subagent byte-exact reuse
  • Chapter 05: Query Loop — AsyncGenerator state machine in query.ts, streaming tool execution, auto-compact pipeline, error recovery (withhold/resume), multi-stage context compression
  • Chapter 06: Context Management — token budget system, auto-compact thresholds, compact/microcompact/reactive-compact strategies, FileStateCache LRU

Details

These three chapters complete Part 2 (AI Core) of the book series. Chapter 04 was further refined based on detailed review feedback addressing 7 accuracy issues (missing sections, cache block structure, fork subagent path, etc.).

Also includes minor updates to plan.md (corrected key file lists) and chapters 01-03 (path reference cleanup).

🤖 Generated with Claude Code

Add three new articles to the Claude Code CLI source study series:

- Chapter 04: System Prompt Engineering — covers the two-phase prompt
  assembly architecture (static/dynamic boundary for cache optimization),
  the systemPromptSection/DANGEROUS_uncachedSystemPromptSection caching
  system, 4-block splitSysPromptPrefix() cache splitting, internal vs
  external prompt variants, prompt priority hierarchy, and fork subagent
  byte-exact prompt reuse.

- Chapter 05: Query Loop — analyzes query.ts's AsyncGenerator state
  machine driving the full AI interaction cycle, including streaming
  tool execution, auto-compact pipeline, error recovery with withhold/
  resume pattern, and the multi-stage context compression chain.

- Chapter 06: Context Management — details the token budget system,
  auto-compact threshold calculation, compact/microcompact/reactive-
  compact strategies, and FileStateCache LRU optimization.

Also updates:
- plan.md: corrected key file lists for chapters 04-06 based on actual
  source code analysis
- Chapters 01-03: minor path reference updates
- TOC (chapter 00): removed hardcoded output path references

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@luyao618 luyao618 merged commit 3c49d29 into main Apr 2, 2026
@luyao618 luyao618 deleted the docs/add-chapters-04-05-06 branch May 21, 2026 13:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant