Add Agent Teams documentation and enhance README

[arjunjaggi34]

Summary

This PR introduces comprehensive documentation for Claude Code Agent Teams integration with Open Org skills, along with significant README enhancements to improve project visibility and onboarding.

Key Changes

• New AGENTS.md document — Complete guide to Agent Teams covering:

  • Conceptual overview of how agent teams coordinate multiple Claude Code instances
  • Setup instructions and environment configuration
  • Comparison table between subagents and agent teams
  • Practical examples mapping Open Org skill hierarchies to agent team structures (Research Team, Marketing Team)
  • Team control mechanisms (in-process mode, split-pane mode, plan approval workflows)
  • Best practices for Open Org workflows including skill context, work assignment, quality gates, and task sizing
  • Architecture reference and known limitations

• Enhanced README.md — Restructured and expanded with:

  • New "Quick Start" section with installation and skill loading examples
  • "Vision" statement clarifying OpenOrg's mission for autonomous organizations
  • "Core Features" section highlighting multi-AI support, org-wide automation, composable stacks, extensibility, and agentic teams
  • Updated table of contents reflecting new sections
  • Improved "Contributing" section with clearer steps and reference to AGENTS.md for multi-agent workflows
  • New "Roadmap" section with 5 milestones (v0.5 through v3.0) tracking skill library expansion, autonomy benchmarks, agent teams integration, enterprise runtime, and unicorn playbook

Notable Details

• AGENTS.md provides both conceptual and practical guidance, with ASCII diagrams showing team structures and natural language examples for spawning teams
• README reorganization improves discoverability by front-loading quick start and vision before technical details
• Roadmap establishes clear project trajectory and invites community engagement through issue tracking
• Cross-references between AGENTS.md and README create cohesive documentation experience

https://claude.ai/code/session_01HyEkBoMWWmjzp3QvitQsvm