Skip to content

christopherlouet/claude-base / .claude/skills/work-plan

work-plan

Verified

Plan the implementation of a feature. Use when the user wants to plan, architect, define an approach, or before coding a complex feature.

FileKindSize
SKILL.mdskill md2.2 KB
examples/planning-example.mdmarkdown3.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**
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall