Agent Playground

This repository is a documentation and starter-pattern workspace for designing cloud agent systems.

It compares major cloud agent approaches, captures workflow-first design guidance, and packages those ideas so they can be used from both GitHub Copilot and Claude Code.

The core premise is simple: agent design should start from workflows, data, permissions, observability, and evaluation, not from prompts alone.

What This Repo Contains

• Shared design docs in docs/
• Cloud-provider reference folders in docs/cloud-platforms/
• Example artifacts in examples/cloud-platforms/
• GitHub Copilot repository instructions and skills in .github/
• Claude Code project guidance and commands in .claude/ and CLAUDE.md

What This Repo Is For

Use this repository to:

• Design workflow-first cloud agents and skills
• Compare how major cloud agent platforms think about orchestration
• Create provider-specific starting points and examples
• Define evaluation and post-launch review patterns
• Support both GitHub Copilot and Claude Code without duplicating the core guidance

Start Here

Read these first:

1. docs/README.md
2. docs/nate-agent-foundations.md
3. docs/skills-as-agents-checklist.md

Then use the cloud platform material:

1. docs/cloud-platforms-overview.md
2. docs/cloud-platform-stage-map.md
3. docs/cloud-platforms-detailed-notes.md
4. docs/cloud-platforms/

If you want concrete samples, then use:

1. examples/cloud-platforms/

Tooling Layout

GitHub Copilot

• Repository instructions: .github/copilot-instructions.md
• Path instructions: .github/instructions/
• Skills: .github/skills/

Claude Code

• Project guidance: CLAUDE.md
• Project commands: .claude/commands/

Documentation Layout

• docs/nate-agent-foundations.md: Core build order for agent design
• docs/skills-as-agents-checklist.md: Pre-build gate for skill or agent readiness
• docs/cloud-platforms-overview.md: Fast comparison of cloud agent platforms
• docs/cloud-platform-stage-map.md: Stage-by-stage provider framing
• docs/cloud-platforms-detailed-notes.md: Deeper provider notes
• docs/cloud-platforms/: One folder per provider with a local README
• docs/nate-post-build-follow-up.md: Post-launch review guidance

Example Layout

• examples/cloud-platforms/: Non-Markdown sample files for each provider approach

Documentation stays in docs/. Example code and configuration stay in examples/.

Working Principle

Keep docs/ as the shared source of truth. Tool-specific files in .github/ and .claude/ should point back to the docs rather than re-explaining the whole system.

The repo is not primarily a Copilot repo or a Claude repo. It is a cloud-agent design repo that includes first-class entrypoints for both.