opencode/picoclaw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
picoclaw/docs/architecture
History
anthrodjear ab23be43a9 docs: add project documentation and architecture guides 
Add comprehensive documentation including:
- CLAUDE.md for build instructions and environment setup
- project-map.md for directory structure and key file overview
- docs/reference/tools-api.md for detailed tools API and architecture
- session-log.md for tracking development decisions
- updates to plugin tool injection documentation regarding security risks
2026-05-05 05:49:21 +03:00
..
agent-refactor refactor(agent): Agent Looper refactor phase2, restructure pipeline and rename loop files to agent (#2585) 2026-04-21 10:55:50 +08:00
hooks docs: add project documentation and architecture guides 2026-05-05 05:49:21 +03:00
README.md feat(events): add configurable runtime event logging 2026-04-26 17:41:00 +08:00
routing-system.md refactor(agent): Agent Looper refactor phase2, restructure pipeline and rename loop files to agent (#2585) 2026-04-21 10:55:50 +08:00
routing-system.zh.md docs: add session and routing documentation (#2571) 2026-04-17 21:25:18 +08:00
runtime-events.md feat(events): add configurable runtime event logging 2026-04-26 17:41:00 +08:00
runtime-events.zh.md feat(events): add configurable runtime event logging 2026-04-26 17:41:00 +08:00
session-system.md refactor(agent): Agent Looper refactor phase2, restructure pipeline and rename loop files to agent (#2585) 2026-04-21 10:55:50 +08:00
session-system.zh.md docs: add session and routing documentation (#2571) 2026-04-17 21:25:18 +08:00
steering.md refactor(docs): reorganize docs by type and locale 2026-04-17 14:00:45 +08:00
subturn.md feat(gateway): publish lifecycle runtime events 2026-04-26 17:02:48 +08:00

README.md

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)
  • Runtime Events: runtime event envelope, centralized event logging, filters, and examples. (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/.