docs(agent): restructure agent-workflows docs into documentation/projects/scratch/archive

[mmabrouk]

What

Restructures the docs/design/agent-workflows/ folder from a flat pile of ~40 top-level
files into four clearly-scoped layers, so living design docs stay separate from in-flight
project notes and historical archaeology.

Layout

Folder	Holds
documentation/	Living design docs kept current with the code: architecture, protocol, ports-and-adapters, sessions, triggers, agent-template, ground-truth, tools, and adapters/.
projects/	Active, self-contained workstreams (qa, sdk-local-tools, tool-resolution-layering, sidecar-deployment-proposal, sandbox-agent-refactor, research, and the docs-lane projects that stack on top).
scratch/	Transient coordination: status, open-issues, pr-stack, implementation-review, meeting-alignment, feature-matrix-test, branch-cleanup reports. These drop off and move to archive/ over time.
archive/	Renamed from trash/. Superseded notes, old RFCs, finished work-package spikes. Kept for archaeology only.
trash/	New, empty. Truly disposable items.

The top-level README.md is rewritten as an index of the four layers.

Why

The flat folder had grown to the point where you could not tell a current design doc from a
stale status report from a dead RFC. The new split makes "is this true today?" answerable
by location.

Notes

• This PR carries only the files that live on big-agents. The per-project docs lanes
  (model-config, skills-config, code-tool-sandbox, harness-capabilities) each move their own
  folder into projects/ within their own PR, so each diff stays self-contained.
• Pure moves plus the README rewrite. No content changes to the moved files.

https://claude.ai/code/session_01K1B1nizzup79YAnc2wF77L

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agenta-documentation	Error		Jun 23, 2026 12:23pm

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: a6056531-2b6b-43d1-b923-f49066a19c33

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/agent-workflows-reorg

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}