docs: architecture review — fix inaccuracies and add potential challenges#4

FisherSkyi merged 2 commits intoclaude/issue-2-20260321-1420openhalibut/NetColab:claude/issue-2-20260321-1420from

copilot/sub-pr-3openhalibut/NetColab:copilot/sub-pr-3Copy head branch name to clipboard