1a0f458e1a
Critical fixes: - Fix argument mismatch (accept 'core' and '--core' formats) - Fix bash 3.2 compatibility (replace mapfile with while-read loops) - Fix process substitution issues (use temp files) - Add platform detection (macOS/Linux/Windows) - Add bash version check (3.2+ required) - Add conditional color support for Windows terminals Enhancements: - Platform-specific dependency installation instructions - Improved help text with usage examples - Better error messages for unsupported platforms Testing: - Add comprehensive compatibility test suite (12 tests) - Add collision detection tests - Organize tests in scripts/tests/ directory - All tests pass on macOS (bash 3.2.57) Documentation: - Add Windows installation instructions to README - Add platform compatibility guide - Add COMPATIBILITY.md quick reference - Update all test script references Tested on: - macOS 13+ (bash 3.2.57) ✓ - Linux (bash 4.0+) ✓ - Windows Git Bash (bash 4.4+) ✓ Closes issues with curl installation failing on macOS and Windows
117 lines
3.1 KiB
Markdown
117 lines
3.1 KiB
Markdown
# GitHub Repository Settings Checklist
|
|
|
|
After merging this PR, update these GitHub repository settings:
|
|
|
|
## 1. About Section
|
|
|
|
**Current:** (needs update)
|
|
|
|
**New Description:**
|
|
```
|
|
AI agent framework for plan-first development workflows with approval-based execution. Multi-language support (TypeScript, Python, Go, Rust) with automatic testing, code review, and validation.
|
|
```
|
|
|
|
**Website:** `https://github.com/darrenhinde/opencode-agents`
|
|
|
|
## 2. Topics (Add All 16)
|
|
|
|
Go to: Settings → General → Topics
|
|
|
|
**Must-Have Topics (10):**
|
|
- `ai-agents`
|
|
- `code-generation`
|
|
- `developer-tools`
|
|
- `llm`
|
|
- `typescript`
|
|
- `python`
|
|
- `automation`
|
|
- `testing`
|
|
- `opencode`
|
|
- `workflow`
|
|
|
|
**Nice-to-Have Topics (6):**
|
|
- `prompt-engineering`
|
|
- `go`
|
|
- `rust`
|
|
- `code-validation`
|
|
- `context-aware`
|
|
- `multi-language`
|
|
|
|
## 3. Social Preview Image
|
|
|
|
Go to: Settings → General → Social Preview
|
|
|
|
**Action:** Upload a 1280x640px image showing:
|
|
- Repository name
|
|
- Tagline: "Plan-First AI Development Framework"
|
|
- Key features icons (agents, testing, validation)
|
|
- Your branding
|
|
|
|
**Quick Option:** Use Canva or similar to create from template
|
|
|
|
## 4. Features to Enable
|
|
|
|
Go to: Settings → General → Features
|
|
|
|
**Enable:**
|
|
- ✅ Wikis (for extended documentation)
|
|
- ✅ Issues (already enabled)
|
|
- ✅ Discussions (for community Q&A)
|
|
- ✅ Projects (for roadmap tracking)
|
|
|
|
## 5. Issue Labels
|
|
|
|
Go to: Issues → Labels
|
|
|
|
**Add these labels:**
|
|
- `good first issue` (color: #7057ff) - For newcomers
|
|
- `help wanted` (color: #008672) - Community contributions welcome
|
|
- `documentation` (color: #0075ca) - Documentation improvements
|
|
- `enhancement` (color: #a2eeef) - New features
|
|
- `bug` (color: #d73a4a) - Something isn't working
|
|
- `question` (color: #d876e3) - Further information requested
|
|
|
|
## 6. GitHub Discussions
|
|
|
|
Go to: Settings → General → Features → Discussions
|
|
|
|
**Enable Discussions** and create these categories:
|
|
- 💡 Ideas - Feature requests and suggestions
|
|
- 🙏 Q&A - Questions and answers
|
|
- 📣 Announcements - Updates and releases
|
|
- 💬 General - General discussion
|
|
- 🎨 Show and Tell - Share your workflows
|
|
|
|
## 7. Branch Protection (Optional but Recommended)
|
|
|
|
Go to: Settings → Branches → Add rule
|
|
|
|
**For `main` branch:**
|
|
- ✅ Require pull request reviews before merging
|
|
- ✅ Require status checks to pass before merging
|
|
- ✅ Require conversation resolution before merging
|
|
|
|
## Verification Checklist
|
|
|
|
After completing the above:
|
|
|
|
- [ ] About section updated with keyword-rich description
|
|
- [ ] All 16 topics added
|
|
- [ ] Social preview image uploaded
|
|
- [ ] Discussions enabled
|
|
- [ ] Issue labels created
|
|
- [ ] At least 2-3 issues created with "good first issue" label
|
|
- [ ] First discussion post created welcoming contributors
|
|
|
|
## Quick Win Metrics
|
|
|
|
After these changes, you should see within 1 week:
|
|
- 📈 Improved GitHub search ranking for "AI agents", "code generation"
|
|
- 👀 Increased profile views from topic pages
|
|
- ⭐ More stars from improved discoverability
|
|
- 💬 Community engagement in Discussions
|
|
|
|
---
|
|
|
|
**Estimated Time:** 30-45 minutes total
|
|
**Expected Impact:** 10x improvement in discoverability
|