docs: accuracy audit — fix lies, stale content, and gaps#360
Merged
Conversation
…ocumentation
Cross-referenced every doc file against the actual codebase. 24 fixes across 13 files:
Lies fixed (6):
- Remove browser_evaluate from README, agent-tools.md, security.md (skill was
removed for security in prior review but docs never updated)
- Fix cap_drop claim in security.md (no NET_BIND_SERVICE re-added — code only
drops ALL)
- Fix browser container RAM in security.md (2-8GB scaled by fleet, not fixed 2GB)
- Remove AGENTS.md from memory.md workspace table (migrated to INSTRUCTIONS.md)
Stale content fixed (3):
- Update test count badge from 1744 to 1826 (README, development.md)
- Note browser_evaluate removal in ROADMAP.md historical entry
- Expand agent server endpoint list in architecture.md (was 3, actually 14+)
Missing documentation added (11):
- /webhook/trigger/{workflow_name} and /webhook/status/{execution_id} endpoints
- 4 undocumented dashboard API endpoints (workflow cancel, channels list,
agent templates, browser focus)
- PUT /mesh/cron/{job_id} for updating cron jobs
- Subagent MAX_TTL=600s upper bound
- soul field in agents.yaml configuration
- Workspace file character caps (4K-16K per file, 40K total bootstrap)
- browser_scroll tool in README tools table
Vague content clarified (4):
- Clarify /steer and /debug are conditionally available
- Note config files are auto-created during setup
- Explicitly list providers that default to embedding "none"
- Add soul field to agent config reference
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Full documentation accuracy audit. Cross-referenced every doc file against the actual codebase and fixed every discrepancy found.
24 fixes across 13 files:
Lies fixed (6)
browser_evaluatefrom README, agent-tools.md, security.md (skill was removed for security in prior review but docs never updated)cap_dropclaim in security.md (noNET_BIND_SERVICEre-added — code only drops ALL)AGENTS.mdfrom memory.md workspace table (migrated toINSTRUCTIONS.md)Stale content fixed (3)
browser_evaluateremoval in ROADMAP.md historical entryMissing documentation added (11)
/webhook/trigger/{workflow_name}and/webhook/status/{execution_id}endpoints in workflows.mdPUT /mesh/cron/{job_id}for updating cron jobs in triggering.mdMAX_TTL=600supper bound in agent-tools.mdsoulfield in agents.yaml configurationbrowser_scrolltool in README tools tableVague content clarified (4)
/steerand/debugare conditionally available in channels.md"none"in configuration.mdsoulfield to agent config reference tableTest plan
pytest— 1800 passed, 0 failed, 7 skipped, 2 pre-existing deselectedbrowser_evaluatereferences (except CLAUDE.md changelog and ROADMAP.md historical note with removal annotation)1744references