picoclaw/docs/architecture
2026-04-19 12:01:26 +02:00
..
agent-refactor feat(freeride): integrate freeride changes from upstream projects, excluding core config logic 2026-04-19 12:01:26 +02:00
hooks feat(freeride): integrate freeride changes from upstream projects, excluding core config logic 2026-04-19 12:01:26 +02:00
README.md feat(freeride): integrate freeride changes from upstream projects, excluding core config logic 2026-04-19 12:01:26 +02:00
routing-system.md feat(freeride): integrate freeride changes from upstream projects, excluding core config logic 2026-04-19 12:01:26 +02:00
routing-system.zh.md feat(freeride): integrate freeride changes from upstream projects, excluding core config logic 2026-04-19 12:01:26 +02:00
session-system.md feat(freeride): integrate freeride changes from upstream projects, excluding core config logic 2026-04-19 12:01:26 +02:00
session-system.zh.md feat(freeride): integrate freeride changes from upstream projects, excluding core config logic 2026-04-19 12:01:26 +02:00
steering.md feat(freeride): integrate freeride changes from upstream projects, excluding core config logic 2026-04-19 12:01:26 +02:00
subturn.md feat(freeride): integrate freeride changes from upstream projects, excluding core config logic 2026-04-19 12:01:26 +02:00

Architecture

Internal architecture notes for major runtime mechanisms and subsystem design.

  • Steering: injecting messages into a running agent loop between tool calls.
  • SubTurn Mechanism: sub-agent coordination, concurrency control, and lifecycle handling.
  • Session System: session scope allocation, JSONL persistence, alias compatibility, and migration. (ZH)
  • Routing System: agent dispatch, session policy selection, and light/heavy model routing. (ZH)
  • Hook System Guide: current hook architecture and protocol details.
  • Agent Refactor: notes and checkpoints for the agent refactor work.

For proposal-style or exploratory docs, also see ../design/.