docs: add 'How to add a provider' guide and link it in README (GPT5)

[devin-ai-integration]

docs: add 'How to add a provider' guide and link it in README

This PR adds a comprehensive “How to add a provider” guide and links it from the main README.

Requested by: Alec Fong (@theFong)
Link to Devin run: https://app.devin.ai/sessions/0459b0ec7cc14278a6a5244af378a333

Summary of changes:

• Add docs/how-to-add-a-provider.md
  • Step-by-step instructions to implement a new provider
  • Canonical references to Lambda Labs provider (client, instance, capabilities)
  • Links to key docs: docs/ARCHITECTURE.md, docs/SECURITY.md, docs/VALIDATION_TESTING.md, pkg/v1/*.go
  • Copy/paste scaffolds for credentials, client, capabilities, and instance ops
• Update README.md
  • Add a prominent link to the new guide in the Documentation section

Verification:

• make lint: passed
• make test: passed

Notes:

• Docs-only changes; no provider code modified.
• CI should pass without provider credentials (validation tests are skipped under -short in default test).

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[devin-ai-integration]

Link to Devin run: https://app.devin.ai/sessions/0459b0ec7cc14278a6a5244af378a333

Requested by: Alec Fong (@theFong)

Summary:

• Adds docs/how-to-add-a-provider.md (step-by-step guide using Lambda Labs as the canonical example)
• Updates README.md to link the new guide

Happy to address any feedback directly on this PR.