Polish README with architecture diagram, quickstart, and agentctl GIF

[shreyanshjain7174]

Update top-level README to be launch-ready. Add architecture diagram, embed agentctl demo GIF, polish quickstart so a fresh user can install + run multi-agent-swarm in <10 minutes.

Acceptance criteria:

• Architecture diagram (mermaid or image)
• Quickstart tested end-to-end on fresh kind cluster
• agentctl demo GIF embedded
• All anchor links work

[shreyanshjain7174]

Triage (2026-04-26)

Already implemented

• Architecture diagram — Mermaid flowchart in README ## Architecture section
• Quickstart — ## Quick Start section with k3d cluster + helm install + kubectl apply
• Demo — 24s Remotion-rendered GIF embedded in ## Demo section
• Badges — brand-blue shields with Discord, CI, license, version

Remaining gap

• agentctl GIF — terminal recording of agentctl init / agentctl status / agentctl approve flow. Low-effort with asciinema or terminalizer.

Proposed approach

1. Record a 15-20s asciinema session showing agentctl init, agentctl status -o table, agentctl approve workflow
2. Convert to GIF via agg (asciinema GIF generator) at 80-col width, dark background
3. Add as assets/agentctl-demo.gif, embed under the existing quickstart section
4. Confidence: 95% — this is a straight recording task, no design ambiguity

Decision needed

• Is the agentctl GIF worth blocking launch on? I'd close this issue as-is and file a separate P2 for the CLI GIF. The README is already strong enough for HN.

[shreyanshjain7174]

Closing: README polish core requirements are met (architecture diagram, quickstart section, demo GIF, badges, community links). The only remaining nice-to-have was the agentctl terminal-recording GIF, which is now tracked separately as P2 in #132. Not a launch blocker.