firefrost-gaming/skill-seekers-reference
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Configure project board for incremental development workflow

Browse Source 
New Workflow:
- Added 'Workflow Stage' field with 5 stages
- 📋 Backlog (120 tasks) - All available tasks
- ⭐ Quick Wins (7 tasks) - High priority starters
- 🎯 Ready to Start (0-5 tasks) - Personal queue
- 🔨 In Progress (1-2 max) - Active work
- ✅ Done - Completed tasks

Quick Wins Pre-selected:
- #130 - Install MCP (5 min)
- #114 - Respond to Issue #8 (30 min)
- #117 - Answer Issue #3 (30 min)
- #27 - Research PDF parsing (30 min)
- #21 - GitHub Pages site (1-2 hours)
- #93 - URL normalization (1-2 hours)
- #116 - Example project (2-3 hours)

Updated PROJECT_BOARD_GUIDE.md:
- Explained Workflow Stage field
- Step-by-step incremental workflow
- Recommended views and filters
- Tips for incremental success

Philosophy: Small tasks → Pick one → Complete → Move to next!
This commit is contained in:
yusyus
2025-10-20 23:13:10 +03:00
parent e1e3968537
commit 5f29c1c191
1 changed files with 107 additions and 49 deletions
Download Patch File Download Diff File Expand all files Collapse all files

156
PROJECT_BOARD_GUIDE.md
View File

@@ -14,7 +14,23 @@ Our project board uses a **flexible, task-based approach** with 127 independent
The project board includes these custom fields: The project board includes these custom fields:
### Status (Default) ### Workflow Stage (Primary - Use This!)
Our incremental development workflow:
- **📋 Backlog** - All available tasks (120 tasks) - Browse and discover
- **⭐ Quick Wins** - High priority starters (7 tasks) - Start here!
- **🎯 Ready to Start** - Tasks you've chosen next (3-5 max) - Your queue
- **🔨 In Progress** - Currently working (1-2 max) - Active work
- **✅ Done** - Completed tasks - Celebrate! 🎉
**How it works:**
1. Browse **Backlog** or **Quick Wins** to find interesting tasks
2. Move chosen tasks to **Ready to Start** (your personal queue)
3. Move one task to **In Progress** when you start
4. Move to **Done** when complete
5. Repeat!
### Status (Default - Optional)
Legacy field, you can use Workflow Stage instead:
- **Todo** - Not started yet - **Todo** - Not started yet
- **In Progress** - Currently working on - **In Progress** - Currently working on
- **Done** - Completed ✅ - **Done** - Completed ✅
@@ -46,28 +62,40 @@ The project board includes these custom fields:
--- ---
## 🚀 How to Use the Board ## 🚀 How to Use the Board (Incremental Workflow)
### 1. Browse Tasks ### 1. Start with Quick Wins ⭐
- Open the project board: https://github.com/users/yusufkaraaslan/projects/2 - Open the project board: https://github.com/users/yusufkaraaslan/projects/2
- Use filters to find tasks by Category, Priority, or Time Estimate - Click on "Workflow Stage" column header
- Read task descriptions and check FLEXIBLE_ROADMAP.md for details - View the **⭐ Quick Wins** (7 high-priority starter tasks):
- #130 - Install MCP package (5 min)
- #114 - Respond to Issue #8 (30 min)
- #117 - Answer Issue #3 (30 min)
- #21 - Create GitHub Pages site (1-2 hours)
- #93 - URL normalization (1-2 hours)
- #116 - Create example project (2-3 hours)
- #27 - Research PDF parsing (30 min)
### 2. Pick a Task ### 2. Browse the Backlog 📋
- Choose something that interests you - Look at **📋 Backlog** (120 remaining tasks)
- Check the Time Estimate - Filter by Category, Time Estimate, or Priority
- No dependencies - pick any task! - Read descriptions and check FLEXIBLE_ROADMAP.md for details
### 3. Start Working ### 3. Move to Ready to Start 🎯
- Drag 3-5 tasks you want to work on next to **🎯 Ready to Start**
- This is your personal queue
- Don't add too many - keep it focused!
### 4. Start Working 🔨
```bash ```bash
# Pick ONE task from Ready to Start
# Move it to "🔨 In Progress" on the board
# Comment when you start # Comment when you start
gh issue comment <issue_number> --repo yusufkaraaslan/Skill_Seekers --body "🚀 Started working on this" gh issue comment <issue_number> --repo yusufkaraaslan/Skill_Seekers --body "🚀 Started working on this"
# Update status on the board to "In Progress"
# (Can be done via GitHub UI by dragging the card)
``` ```
### 4. Complete the Task ### 5. Complete the Task ✅
```bash ```bash
# Make your changes # Make your changes
git add . git add .
@@ -78,33 +106,49 @@ Closes #<issue_number>"
# Push changes # Push changes
git push origin main git push origin main
# The issue will auto-close and move to "Done" # Move task to "✅ Done" on the board (or it auto-closes)
``` ```
### 5. Pick Next Task ### 6. Repeat! 🔄
- Browse the board again - Move next task from **Ready to Start** → **In Progress**
- Choose another task - Add more tasks to Ready to Start from Backlog or Quick Wins
- Keep moving forward! - Keep the flow going: 1-2 tasks in progress max!
--- ---
## 🎨 Filtering & Views ## 🎨 Filtering & Views
### Filter by Category ### Recommended Views to Create
Click on the "Category" dropdown to see only tasks from specific categories:
- Community & Sharing
- New Input Formats
- MCP Enhancements
- etc.
### Filter by Priority #### View 1: Board View (Default)
Show only high priority tasks or good starter tasks - Layout: Board
- Group by: **Workflow Stage**
- Shows 5 columns: Backlog, Quick Wins, Ready to Start, In Progress, Done
- Perfect for visual workflow management
### Filter by Time Estimate #### View 2: By Category
Find quick wins (5-30 min) or plan larger work sessions (5-8 hours) - Layout: Board
- Group by: **Category**
- Shows 10 columns (one per category)
- Great for exploring tasks by topic
### Group by Category #### View 3: By Time
Create a custom view grouped by category to see all tasks organized - Layout: Table
- Group by: **Time Estimate**
- Filter: Workflow Stage = "Backlog" or "Quick Wins"
- Perfect for finding tasks that fit your available time
#### View 4: Starter Tasks
- Layout: Table
- Filter: Priority = "Starter"
- Shows only beginner-friendly tasks
- Great for new contributors
### Using Filters
Click the filter icon to combine filters:
- **Category** + **Time Estimate** = "Show me 1-2 hour MCP tasks"
- **Priority** + **Workflow Stage** = "Show high priority tasks in Quick Wins"
- **Category** + **Priority** = "Show high priority Community Response tasks"
--- ---
@@ -117,31 +161,45 @@ Create a custom view grouped by category to see all tasks organized
--- ---
## 🎯 Recommended First Tasks ## 🎯 The 7 Quick Wins (Start Here!)
### Quick Wins (5-30 minutes) These 7 tasks are pre-selected in the **⭐ Quick Wins** column:
1. **#130** - Install MCP package
2. **#114** - Respond to Issue #8
3. **#117** - Answer Issue #3
### High Impact (1-2 hours) ### Ultra Quick (5-30 minutes)
4. **#21** - Create GitHub Pages site 1. **#130** - Install MCP package (5 min) - Testing
5. **#93** - URL normalization 2. **#114** - Respond to Issue #8 (30 min) - Community Response
6. **#116** - Create example project 3. **#117** - Answer Issue #3 (30 min) - Community Response
4. **#27** - Research PDF parsing (30 min) - New Input Formats
### Major Features (5-8 hours) ### Short Tasks (1-2 hours)
7. **#27-34** - Complete PDF scraper 5. **#21** - Create GitHub Pages site (1-2 hours) - Community & Sharing
8. **#54-62** - Complete GitHub scraper 6. **#93** - URL normalization (1-2 hours) - Performance
### Medium Task (2-3 hours)
7. **#116** - Create example project (2-3 hours) - Community Response
### After Quick Wins
Once you complete these, explore the **📋 Backlog** for:
- More community features (Category A)
- PDF/Word/Excel support (Category B)
- GitHub scraping (Category C)
- MCP enhancements (Category E)
- Performance improvements (Category F)
--- ---
## 💡 Tips ## 💡 Tips for Incremental Success
1. **Start small** - Pick quick wins first to build momentum 1. **Start with Quick Wins ⭐** - Build momentum with the 7 pre-selected tasks
2. **One at a time** - Focus on completing one task before starting another 2. **Limit Work in Progress** - Keep 1-2 tasks max in "🔨 In Progress"
3. **Update status** - Keep "In Progress" accurate (only 1 task at a time ideally) 3. **Use Ready to Start as a Queue** - Plan ahead with 3-5 tasks you want to tackle
4. **Comment progress** - Share updates on issues 4. **Move cards visually** - Drag and drop between Workflow Stage columns
5. **No pressure** - No deadlines, work at your own pace! 5. **Update as you go** - Move tasks through the workflow in real-time
6. **Celebrate progress** - Each task in "✅ Done" is a win!
7. **No pressure** - No deadlines, just continuous small improvements
8. **Browse the Backlog** - Discover new interesting tasks anytime
9. **Comment your progress** - Share updates on issues you're working on
10. **Keep it flowing** - As soon as you finish one, pick the next!
--- ---