docs: add example workflows and adoption strategy

Author: clouatre

ADOPTION_STRATEGY.md

@@ -0,0 +1,259 @@
+# Adoption Strategy for setup-goose-action
+
+Comprehensive plan to drive awareness and adoption.
+
+## Phase 1: Community Awareness (Week 1)
+
+### Goose Community
+- [ ] Post announcement in Goose Discord (#announcements, #showcase)
+- [ ] Share in Goose discussions: https://github.com/block/goose/discussions
+- [ ] Comment on relevant Goose issues/PRs mentioning CI/CD use cases
+
+### Social Media
+- [ ] Twitter/X thread with examples and use cases
+- [ ] LinkedIn post targeting DevOps/SRE audience
+- [ ] Bluesky announcement (Block is active there)
+- [ ] Dev.to article: "Automating Code Review with Goose and GitHub Actions"
+- [ ] Hashnode/Medium cross-post
+
+### GitHub
+- [ ] Add to Awesome Goose lists (if they exist)
+- [ ] Submit to Awesome GitHub Actions: https://github.com/sdras/awesome-actions
+- [ ] Post in GitHub Actions community discussions
+
+---
+
+## Phase 2: Content Marketing (Week 2-3)
+
+### Blog Posts / Articles
+1. **"How to Add AI Code Review to Your CI/CD Pipeline"**
+   - Problem: Manual code review bottlenecks
+   - Solution: Automated AI review with Goose
+   - Tutorial: Step-by-step setup
+   - Results: Time savings, quality improvements
+
+2. **"3 Ways Goose GitHub Action Improves Your Workflow"**
+   - PR review automation
+   - Test generation
+   - Documentation sync
+
+3. **"From Manual to Automated: Our Journey with AI in CI/CD"**
+   - Personal story/case study
+   - Before/after metrics
+   - Lessons learned
+
+### Video Content
+- [ ] YouTube tutorial: "Setup Goose Action in 5 Minutes"
+- [ ] Loom demo: Quick walkthrough
+- [ ] Add to video to README
+
+### Documentation
+- [x] Example workflows (created)
+- [ ] Best practices guide
+- [ ] Troubleshooting FAQ
+- [ ] Cost optimization tips
+
+---
+
+## Phase 3: Community Engagement (Ongoing)
+
+### Support & Feedback
+- [ ] Monitor GitHub issues daily
+- [ ] Respond to questions in Goose Discord
+- [ ] Track mentions on Twitter/social
+- [ ] Collect feature requests
+
+### Collaboration
+- [ ] Reach out to Goose maintainers for feedback
+- [ ] Ask Block to mention in Goose docs/blog
+- [ ] Collaborate with other action authors
+- [ ] Contribute examples to block/goose repo
+
+### Showcases
+- [ ] Feature user success stories in README
+- [ ] Create "Built with setup-goose-action" showcase
+- [ ] Highlight innovative use cases
+
+---
+
+## Phase 4: Strategic Partnerships (Month 2+)
+
+### Integration Opportunities
+- [ ] Partner with CI/CD platforms (CircleCI, GitLab CI)
+- [ ] Integrate with code quality tools (SonarQube, CodeClimate)
+- [ ] Create starter templates for popular frameworks
+
+### Conference/Meetup Talks
+- [ ] Submit to GitHub Universe
+- [ ] Present at local DevOps meetups
+- [ ] Guest on AI/DevOps podcasts
+
+### Open Source Projects
+- [ ] Add GitHub Action to popular repos (with permission)
+- [ ] Create PRs adding setup-goose-action to real projects
+- [ ] Sponsor/contribute to related projects
+
+---
+
+## Metrics to Track
+
+### Usage Metrics
+- GitHub Action runs per day/week
+- Unique repositories using the action
+- Stars/forks on repo
+- Marketplace views/installations
+
+### Engagement Metrics
+- GitHub issues opened
+- PR contributions
+- Discord mentions
+- Social media engagement (likes, shares, comments)
+
+### Quality Metrics
+- Issue resolution time
+- User satisfaction (via feedback)
+- Success rate (% of successful runs)
+- Cache hit rate
+
+---
+
+## Quick Wins (Do This Week)
+
+### High Impact, Low Effort
+1. [x] Publish to marketplace (DONE)
+2. [ ] Post to Goose Discord
+3. [ ] Tweet announcement
+4. [ ] Add examples/ directory to repo
+5. [ ] Update README with "Example Use Cases" section
+6. [ ] Submit to awesome-actions list
+7. [ ] Create demo video (5 min)
+8. [ ] Write Dev.to article
+
+### Medium Impact, Medium Effort
+1. [ ] Comprehensive blog post
+2. [ ] Reach out to Block team
+3. [ ] Create video tutorial
+4. [ ] Add to Goose official docs (PR)
+
+---
+
+## Long-term Vision
+
+### Features to Build
+- [ ] Support for Windows runners
+- [ ] Pre-configured profiles (code-review, test-gen, docs)
+- [ ] Output formatters (markdown, JSON, GitHub comments)
+- [ ] Multi-file diff analysis
+- [ ] Integration with GitHub Code Scanning
+
+### Community Growth
+- [ ] Contributor guide
+- [ ] Good first issues
+- [ ] Monthly releases with improvements
+- [ ] User testimonials
+
+---
+
+## Templates for Outreach
+
+### Discord Announcement
+```
+🚀 Exciting news for Goose users!
+
+I just published setup-goose-action to GitHub Marketplace!
+
+Now you can integrate Goose into your CI/CD pipelines:
+
+```yaml
+- uses: clouatre-labs/setup-goose-action@v1
+```
+
+Perfect for:
+✅ Automated PR reviews
+✅ Test generation
+✅ Documentation updates
+✅ Code quality checks
+
+Check it out: https://github.com/marketplace/actions/setup-goose-cli
+
+Examples: https://github.com/clouatre-labs/setup-goose-action/tree/main/examples
+
+Would love your feedback!
+```
+
+### Twitter Thread
+```
+🤖 Thread: How to add AI-powered code review to your GitHub Actions
+
+I just published setup-goose-action - it brings @block's Goose AI agent to your CI/CD pipeline
+
+Here's what you can automate 🧵
+
+1/ First, what is Goose?
+Goose is an open-source AI agent that can write code, run tests, and analyze your codebase.
+
+It's like having a senior developer reviewing every PR.
+
+2/ The problem:
+Manual code review is slow. PRs sit for days waiting for review.
+
+Solution: Automated AI review catches obvious issues before human review.
+
+3/ Setup is dead simple:
+
+```yaml
+- uses: clouatre-labs/setup-goose-action@v1
+```
+
+That's it. Goose is now in your workflow.
+
+4/ Real example - automated PR review:
+[attach screenshot of example workflow]
+
+Goose reviews changed files and comments on issues it finds.
+
+5/ What else can you automate?
+- Generate unit tests
+- Update documentation
+- Refactor code
+- Security scans
+- Migration helpers
+
+6/ Try it yourself:
+Marketplace: https://github.com/marketplace/actions/setup-goose-cli
+Examples: [link]
+
+What would YOU automate with AI in CI/CD? Reply below 👇
+```
+
+---
+
+## Budget Considerations
+
+### Free/Low Cost
+- Social media posting
+- GitHub discussions
+- Discord engagement
+- Blog posts (own blog or Dev.to)
+- Video tutorials (YouTube)
+
+### Paid Options (Optional)
+- Sponsored tweets/posts
+- Conference tickets
+- Paid ads on Dev.to
+- Newsletter sponsorships
+
+---
+
+## Success Criteria (3 Months)
+
+- [ ] 100+ stars on GitHub
+- [ ] 50+ repositories using the action
+- [ ] 10+ community contributions (issues/PRs)
+- [ ] Featured in Goose documentation
+- [ ] 1,000+ GitHub Action runs
+- [ ] 5+ testimonials/case studies
+
+---
+
+**Remember:** Focus on providing value. Share real examples, help users succeed, and build a community around the action.

examples/README.md

@@ -0,0 +1,95 @@
+# Example Workflows
+
+Real-world examples of using setup-goose-action in GitHub Actions.
+
+## Quick Start
+
+All examples require a Goose-compatible API key as a GitHub secret:
+- Google Gemini: `GEMINI_API_KEY`
+- OpenAI: `OPENAI_API_KEY`
+- Anthropic: `ANTHROPIC_API_KEY`
+
+Add your API key to repository secrets: `Settings > Secrets and variables > Actions > New repository secret`
+
+---
+
+## Examples
+
+### 1. [AI Code Review](pr-review.yml)
+Automatically review pull requests for logic issues, bugs, and improvements.
+
+**Use case:** Catch issues before human review, improve code quality
+
+**Triggers:** On PR open/update
+
+**Requirements:** Read access to code, write access to PRs
+
+---
+
+### 2. [Test Generation](test-generation.yml)
+Generate unit tests for new code automatically.
+
+**Use case:** Maintain test coverage, reduce manual test writing
+
+**Triggers:** On PR with new source code
+
+**Requirements:** Write access to create PRs
+
+---
+
+### 3. [Documentation Updates](documentation.yml)
+Keep documentation in sync with code changes.
+
+**Use case:** Prevent stale docs, automated API documentation
+
+**Triggers:** On push to main
+
+**Requirements:** Write access to commit docs
+
+---
+
+## Configuration Tips
+
+### Performance Optimization
+```yaml
+- uses: clouatre-labs/setup-goose-action@v1
+  with:
+    version: '1.14.0'  # Pin version for reproducibility
+```
+
+### Multi-Model Strategy
+```yaml
+env:
+  # Use fast model for simple tasks
+  GOOSE_MODEL: gemini-2.0-flash-exp
+  GOOGLE_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+```
+
+### Cost Control
+```yaml
+# Run only on specific paths
+on:
+  pull_request:
+    paths:
+      - 'src/**'
+      - '!src/test/**'  # Exclude test files
+```
+
+---
+
+## Custom Workflows
+
+Copy and adapt these examples for your needs:
+- Code migration (framework upgrades)
+- Security scanning (vulnerability detection)
+- Refactoring suggestions
+- Changelog generation
+- Release notes writing
+
+---
+
+## Support
+
+- Report issues: https://github.com/clouatre-labs/setup-goose-action/issues
+- Goose docs: https://block.github.io/goose/
+- Goose Discord: https://discord.gg/goose-oss