christopherlouet/claude-base / .claude/skills/work-plan
work-plan
VerifiedPlan the implementation of a feature. Use when the user wants to plan, architect, define an approach, or before coding a complex feature.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.2 KB |
| examples/planning-example.md | markdown | 3.1 KB |
examples/planning-example.md
View on GitHub# Implementation planning example
## Context
Add a real-time notification system to an application.
## Product plan
### Objective
Allow users to receive real-time notifications (new messages, mentions, system alerts).
### Acceptance criteria
- [ ] Real-time push notifications
- [ ] Unread counter badge
- [ ] Notification history
- [ ] Mark as read/unread
- [ ] User preferences
## Technical plan
### Chosen architecture
```
┌─────────────┐ WebSocket ┌─────────────┐
│ Client │◄──────────────────►│ Server │
│ (React) │ │ (Node.js) │
└─────────────┘ └──────┬──────┘
│
┌──────▼──────┐
│ Redis │
│ (Pub/Sub) │
└──────┬──────┘
│
┌──────▼──────┐
│ PostgreSQL │
│ (storage) │
└─────────────┘
```
### Files to create
| File | Description |
|---------|-------------|
| `src/services/websocket.ts` | WebSocket client |
| `src/hooks/useNotifications.ts` | React hook |
| `src/components/NotificationBell.tsx` | UI component |
| `src/components/NotificationList.tsx` | Dropdown list |
| `server/ws/notification-handler.ts` | Server handler |
| `prisma/migrations/xxx_notifications.sql` | DB schema |
### Files to modify
| File | Changes |
|---------|---------------|
| `src/app/layout.tsx` | Add notifications provider |
| `src/components/Header.tsx` | Add NotificationBell |
| `server/index.ts` | Initialize WebSocket server |
### Implementation steps
1. **Backend (day 1-2)**
- [ ] Create `notifications` table in Prisma
- [ ] Implement WebSocket server with Socket.io
- [ ] Configure Redis Pub/Sub
- [ ] Create REST endpoints for history
2. **Frontend (day 3-4)**
- [ ] Create `useNotifications` hook
- [ ] Implement `NotificationBell` with badge
- [ ] Create `NotificationList` with infinite scroll
- [ ] Add animations (Framer Motion)
3. **Integration (day 5)**
- [ ] Connect frontend/backend
- [ ] E2E tests
- [ ] Documentation
### Identified risks
| Risk | Probability | Impact | Mitigation |
|--------|-------------|--------|------------|
| WebSocket disconnections | Medium | High | Auto-reconnect + offline queue |
| Redis overload | Low | High | Rate limiting + TTL |
| List performance | Medium | Medium | Virtualization + pagination |
### Dependencies to add
```bash
npm install socket.io socket.io-client ioredis
```
## Plan validation
- [x] Architecture validated with the team
- [x] Estimates reviewed
- [x] Risks accepted
- [ ] **Ready for implementation**
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |