| name | gap-tracker |
| description | Track and update progress on system design gap implementation. Use when implementing patterns, marking items complete, checking progress, viewing remaining items, or updating the implementation plan. Triggers on "mark complete", "check progress", "show gaps", "update tracker", "what's next", "implementation status". |
| allowed-tools | Read, Write, Edit, Grep, Glob, Bash |
Gap Implementation Tracker
A skill to track progress on implementing system design patterns from the ByteByteGo gap analysis.
File Locations
- Implementation Plan:
docs/gap-analysis/implementation-plan.md - Gap Analyses:
docs/gap-analysis/part_*_gap_analysis.md - System Design Page:
app/system-design/page.tsx
Commands
1. Check Progress
When the user asks to "check progress", "show status", or "implementation status":
- Read the implementation plan file
- Count completed items (lines with
- [x]) - Count remaining items (lines with
- [ ]) - Report summary by phase
Response format:
## Implementation Progress
### Phase 1 (HIGH Priority)
- Completed: X/55
- In Progress: X
- Remaining: X
### Phase 2 (MEDIUM Priority)
- Completed: X/45
- Remaining: X
### Phase 3 (LOW Priority)
- Completed: X/30
- Remaining: X
### Overall: X/130 items completed (X%)
2. Mark Item Complete
When the user says "mark complete [ITEM-ID]" or "completed [ITEM-ID]":
- Read the implementation plan
- Find the line containing the item ID (e.g.,
CACHE-001,K8S-002) - Change
- [ ]to- [x]for that line - Update the Summary Dashboard counts at the top of the file
- Add an entry to the Progress Log with today's date
- Write the updated file
Example:
User: "Mark complete CACHE-001"
→ Find - [ ] **CACHE-001**: and change to - [x] **CACHE-001**:
→ Update dashboard: Phase 1 Completed: 0 → 1, Remaining: 55 → 54
3. Show Next Items
When the user asks "what's next", "show next items", or "what should I work on":
- Read the implementation plan
- Find the first uncompleted items in Phase 1 (HIGH priority)
- Show the next 5 items to work on
- Include the item ID, title, and brief description
Response format:
## Next Items to Implement
1. **CACHE-001**: Thunder Herd Problem
- Diagram showing problem and solutions (locking, early expiration)
2. **CACHE-002**: Cache Penetration
- Queries for non-existent data, Bloom filter solution
[etc.]
4. Show Items by Category
When the user asks "show [category] items" or "list [category] gaps":
- Read the implementation plan
- Filter items by category prefix (e.g., CACHE, K8S, NET, SEC, DB)
- Show all items in that category with completion status
Category prefixes:
CACHE- CachingK8S- KubernetesNET- NetworkingSEC- SecurityDB- DatabaseMICRO- MicroservicesCLOUD- CloudCASE- Case StudiesAPP- Application PatternsDATA- Data EngineeringSEARCH- SearchAI- AI/MLLINUX- Linux/OSAPI- API DesignRT- Real-TimeDEVOPS- DevOpsPERF- PerformanceARCH- ArchitectureMSG- MessagingPAY- PaymentDEV- Developer ResourcesROAD- RoadmapsPROG- ProgrammingWEB- Web/FrontendMISC- Miscellaneous
5. Update Dashboard
When the user says "update dashboard" or after marking items complete:
- Count all
- [x]items in Phase 1, Phase 2, Phase 3 - Update the Summary Dashboard table at the top of the file
- Update the "Last Updated" date
Dashboard format to update:
| Phase | Total Items | Completed | In Progress | Remaining |
|-------|-------------|-----------|-------------|-----------|
| Phase 1 (HIGH) | 55 | [COUNT] | 0 | [55-COUNT] |
| Phase 2 (MEDIUM) | 45 | [COUNT] | 0 | [45-COUNT] |
| Phase 3 (LOW) | 30 | [COUNT] | 0 | [30-COUNT] |
| **TOTAL** | **130** | **[TOTAL]** | **0** | **[130-TOTAL]** |
6. Add Progress Log Entry
When the user says "log progress" or after completing items:
- Find the Progress Log section
- Add a new row with today's date, items completed, and notes
- Write the updated file
Format:
| 2026-01-02 | CACHE-001, CACHE-002 | Implemented caching problems diagrams |
7. Verify Implementation
When the user says "verify [ITEM-ID]" or "check if [ITEM-ID] is implemented":
- Read the item details from implementation plan
- Search the system-design page.tsx for related patterns
- Report whether the pattern exists and completeness
Example Interactions
User: "Check progress" Claude: Reads implementation plan, counts items, reports summary
User: "Mark complete K8S-001" Claude: Updates the item to [x], updates dashboard, logs progress
User: "What's next?" Claude: Shows next 5 uncompleted HIGH priority items
User: "Show all caching items" Claude: Lists all CACHE-* items with their status
User: "I just implemented the Thunder Herd pattern" Claude: Identifies CACHE-001, marks it complete, updates dashboard
Notes
- Always update the dashboard after marking items complete
- Keep the Progress Log updated for tracking velocity
- Phase 1 items should be prioritized over Phase 2 and 3
- When implementing, refer to the original gap analysis files for more details