-
-
Notifications
You must be signed in to change notification settings - Fork 52.7k
Description
Summary
Found several places where documentation doesn't match the actual source code behavior. Collected during a documentation audit.
1. Bootstrap files list incomplete
Location: Workspace/bootstrap docs
Doc says: 6 workspace files are loaded:
AGENTS.md, SOUL.md, TOOLS.md, BOOTSTRAP.md, IDENTITY.md, USER.md
Source shows 8 files (in injection order):
- AGENTS.md
- SOUL.md
- TOOLS.md
- IDENTITY.md
- USER.md
- HEARTBEAT.md ← missing from docs
- BOOTSTRAP.md
- MEMORY.md (or memory.md) ← missing from docs
Reference: workspace.js → loadWorkspaceBootstrapFiles()
2. Queue modes undocumented
Location: Queue/steering docs
The docs mention basic queue modes but don't document:
steer-backlogsteer+backlog
These modes exist in the source code and are valid options.
3. Sub-agent timeoutSeconds default unclear
Location: Sub-agent/spawn docs
Doc says: Default timeoutSeconds is 600s.
Source shows: The zod schema only has z.number().int().positive().optional() with no hardcoded default of 600 found in the relevant source files. The actual default may differ or be applied elsewhere.
Environment
- OpenClaw version: 2026.2.1