musubi-sdd 3.0.0 → 3.5.1

package/src/templates/agents/claude-code/skills/performance-optimizer/optimization-patterns.md

@@ -0,0 +1,273 @@
+# Performance Optimization Patterns
+
+## Overview
+
+Common patterns for optimizing application performance.
+
+---
+
+## 1. Caching Patterns
+
+### Cache-Aside (Lazy Loading)
+
+```typescript
+async function getUser(id: string): Promise<User> {
+  // Try cache first
+  let user = await cache.get(`user:${id}`);
+  
+  if (!user) {
+    // Cache miss - load from DB
+    user = await db.users.findById(id);
+    await cache.set(`user:${id}`, user, { ttl: 3600 });
+  }
+  
+  return user;
+}
+```
+
+**Use When**: Read-heavy workloads
+
+### Write-Through Cache
+
+```typescript
+async function updateUser(id: string, data: Partial<User>): Promise<User> {
+  // Update DB
+  const user = await db.users.update(id, data);
+  
+  // Update cache
+  await cache.set(`user:${id}`, user, { ttl: 3600 });
+  
+  return user;
+}
+```
+
+**Use When**: Data consistency is critical
+
+### Cache Invalidation
+
+```typescript
+async function deleteUser(id: string): Promise<void> {
+  await db.users.delete(id);
+  await cache.delete(`user:${id}`);
+  await cache.delete(`user:${id}:*`); // Related keys
+}
+```
+
+---
+
+## 2. Database Patterns
+
+### Connection Pooling
+
+```typescript
+const pool = new Pool({
+  max: 20,        // Max connections
+  min: 5,         // Min connections
+  idleTimeoutMillis: 30000,
+  connectionTimeoutMillis: 2000,
+});
+```
+
+### Indexing Strategy
+
+```sql
+-- Frequently queried columns
+CREATE INDEX idx_users_email ON users(email);
+
+-- Composite index for common queries
+CREATE INDEX idx_orders_user_date ON orders(user_id, created_at DESC);
+
+-- Partial index for filtered queries
+CREATE INDEX idx_active_users ON users(id) WHERE status = 'active';
+```
+
+### Query Optimization
+
+```typescript
+// BAD: N+1 Query
+const users = await User.findAll();
+for (const user of users) {
+  user.orders = await Order.findByUserId(user.id); // N queries!
+}
+
+// GOOD: Eager loading
+const users = await User.findAll({
+  include: [{ model: Order }]  // 1 query with JOIN
+});
+```
+
+### Pagination
+
+```typescript
+// Offset pagination (simple but slow for large offsets)
+const page = await db.query(
+  'SELECT * FROM items LIMIT $1 OFFSET $2',
+  [pageSize, (page - 1) * pageSize]
+);
+
+// Cursor pagination (efficient)
+const page = await db.query(
+  'SELECT * FROM items WHERE id > $1 ORDER BY id LIMIT $2',
+  [lastSeenId, pageSize]
+);
+```
+
+---
+
+## 3. API Patterns
+
+### Response Compression
+
+```typescript
+import compression from 'compression';
+app.use(compression());
+```
+
+### Field Selection (Sparse Fieldsets)
+
+```typescript
+// GET /users?fields=id,name,email
+app.get('/users', (req, res) => {
+  const fields = req.query.fields?.split(',') || ['*'];
+  const users = await db.query(
+    `SELECT ${fields.join(',')} FROM users`
+  );
+  res.json(users);
+});
+```
+
+### Batch Operations
+
+```typescript
+// BAD: Multiple requests
+await api.getUser(1);
+await api.getUser(2);
+await api.getUser(3);
+
+// GOOD: Batch request
+await api.getUsers([1, 2, 3]);
+```
+
+---
+
+## 4. Async Patterns
+
+### Background Jobs
+
+```typescript
+// Don't block request for slow operations
+app.post('/orders', async (req, res) => {
+  const order = await createOrder(req.body);
+  
+  // Queue async tasks
+  await queue.add('send-confirmation-email', { orderId: order.id });
+  await queue.add('update-inventory', { orderId: order.id });
+  
+  res.json(order); // Respond immediately
+});
+```
+
+### Parallel Execution
+
+```typescript
+// BAD: Sequential
+const users = await getUsers();
+const products = await getProducts();
+const orders = await getOrders();
+
+// GOOD: Parallel
+const [users, products, orders] = await Promise.all([
+  getUsers(),
+  getProducts(),
+  getOrders()
+]);
+```
+
+---
+
+## 5. Frontend Patterns
+
+### Code Splitting
+
+```typescript
+// Lazy load routes
+const Dashboard = React.lazy(() => import('./Dashboard'));
+const Settings = React.lazy(() => import('./Settings'));
+```
+
+### Image Optimization
+
+```html
+<!-- Responsive images -->
+<img 
+  srcset="image-300.jpg 300w, image-600.jpg 600w"
+  sizes="(max-width: 600px) 300px, 600px"
+  loading="lazy"
+  alt="Product"
+/>
+```
+
+### Debouncing
+
+```typescript
+// Debounce search input
+const debouncedSearch = debounce((query) => {
+  api.search(query);
+}, 300);
+
+input.addEventListener('input', (e) => {
+  debouncedSearch(e.target.value);
+});
+```
+
+---
+
+## 6. Performance Metrics
+
+### Key Metrics
+
+| Metric | Target | Tool |
+|--------|--------|------|
+| TTFB | < 200ms | Lighthouse |
+| FCP | < 1.8s | Lighthouse |
+| LCP | < 2.5s | Lighthouse |
+| API p95 | < 200ms | APM |
+| DB p95 | < 50ms | DB monitoring |
+
+### Monitoring Queries
+
+```sql
+-- Slow queries (PostgreSQL)
+SELECT query, calls, mean_time, total_time
+FROM pg_stat_statements
+ORDER BY mean_time DESC
+LIMIT 10;
+```
+
+---
+
+## Optimization Checklist
+
+### Database
+- [ ] Indexes on frequently queried columns
+- [ ] Connection pooling configured
+- [ ] N+1 queries eliminated
+- [ ] Query plans analyzed (EXPLAIN)
+
+### API
+- [ ] Response compression enabled
+- [ ] Pagination implemented
+- [ ] Caching strategy in place
+- [ ] Slow operations moved to background
+
+### Frontend
+- [ ] Code splitting implemented
+- [ ] Images optimized and lazy loaded
+- [ ] CDN for static assets
+- [ ] Bundle size analyzed
+
+### Infrastructure
+- [ ] Auto-scaling configured
+- [ ] Load balancing in place
+- [ ] CDN configured
+- [ ] Monitoring and alerts

package/src/templates/agents/claude-code/skills/project-manager/SKILL.md

@@ -28,6 +28,38 @@ You are a project manager for software development projects who handles project
 
 ---
 
+## Multi-Skill Orchestration (v3.5.0 NEW)
+
+`musubi-orchestrate` CLI で複数のスキルを協調させてタスクを実行できます：
+
+```bash
+# タスクに最適なスキルを自動選択して実行
+musubi-orchestrate auto "ユーザー認証機能を設計して実装"
+
+# 指定したスキルを順番に実行
+musubi-orchestrate sequential --skills requirements-analyst system-architect software-developer
+
+# オーケストレーションパターンを指定して実行
+musubi-orchestrate run group-chat --skills security-auditor code-reviewer performance-optimizer
+
+# 利用可能なパターンを一覧表示
+musubi-orchestrate list-patterns
+
+# 利用可能なスキルを一覧表示
+musubi-orchestrate list-skills
+
+# オーケストレーション状態を確認
+musubi-orchestrate status
+```
+
+**オーケストレーションパターン**:
+- **auto**: タスク内容から最適なスキルを自動選択
+- **sequential**: スキルを順番に実行（依存関係を考慮）
+- **group-chat**: 複数スキルが協議して結論を出す
+- **nested**: 階層的にスキルを委譲
+- **swarm**: 並列実行（P-label戦略）
+- **human-in-loop**: 人間の承認ゲートを含むワークフロー
+
 ---
 
 ## Project Memory (Steering System)

package/src/templates/agents/claude-code/skills/project-manager/agile-ceremonies.md

@@ -0,0 +1,283 @@
+# Agile Ceremonies Guide
+
+## Overview
+
+Guide for running effective Agile ceremonies.
+
+---
+
+## Ceremony Overview
+
+| Ceremony | Frequency | Duration | Participants |
+|----------|-----------|----------|--------------|
+| Sprint Planning | Sprint start | 2-4 hours | Team, PO |
+| Daily Standup | Daily | 15 min | Team |
+| Sprint Review | Sprint end | 1-2 hours | Team, PO, Stakeholders |
+| Retrospective | Sprint end | 1-2 hours | Team |
+| Backlog Refinement | Weekly | 1 hour | Team, PO |
+
+---
+
+## Sprint Planning
+
+### Objectives
+1. Define sprint goal
+2. Select user stories
+3. Create task breakdown
+
+### Agenda
+
+```markdown
+## Sprint Planning Agenda (2 hours)
+
+1. **Review** (15 min)
+   - Velocity trends
+   - Capacity for sprint
+   - Carryover items
+
+2. **Sprint Goal** (15 min)
+   - PO presents priorities
+   - Team discusses goal
+   - Agree on sprint goal
+
+3. **Story Selection** (45 min)
+   - Review top backlog items
+   - Clarify requirements
+   - Estimate if needed
+   - Commit to stories
+
+4. **Task Breakdown** (45 min)
+   - Break stories into tasks
+   - Identify dependencies
+   - Assign initial owners
+```
+
+### Best Practices
+- Come prepared with refined backlog
+- Focus on "what" not "how"
+- Don't overcommit
+- Ensure stories meet Definition of Ready
+
+---
+
+## Daily Standup
+
+### Format
+
+Each team member answers:
+1. What did I complete yesterday?
+2. What will I work on today?
+3. Do I have any blockers?
+
+### Anti-patterns to Avoid
+
+| Anti-pattern | Better Approach |
+|--------------|-----------------|
+| Status report to manager | Team sync |
+| Solving problems in standup | Take offline |
+| Going over 15 minutes | Keep it short |
+| Only talking to Scrum Master | Talk to team |
+| Sitting down | Stand up (energy) |
+
+### Virtual Standup Tips
+- Camera on
+- Mute when not speaking
+- Use visual board
+- Same time daily
+- Async option: posted update by 9am
+
+---
+
+## Sprint Review (Demo)
+
+### Objectives
+1. Demonstrate completed work
+2. Get stakeholder feedback
+3. Discuss backlog priorities
+
+### Agenda
+
+```markdown
+## Sprint Review Agenda (1 hour)
+
+1. **Introduction** (5 min)
+   - Sprint goal recap
+   - What was committed vs completed
+
+2. **Demonstrations** (40 min)
+   - Demo each completed story
+   - Get feedback per item
+   - Note questions for later
+
+3. **Metrics Review** (5 min)
+   - Velocity
+   - Burndown
+   - Quality metrics
+
+4. **Backlog Discussion** (10 min)
+   - Upcoming priorities
+   - Feedback impact on backlog
+   - Release timeline
+```
+
+### Tips for Good Demos
+- Use real scenarios
+- Show working software
+- Keep it interactive
+- Collect feedback actively
+- Celebrate accomplishments
+
+---
+
+## Retrospective
+
+### Objectives
+1. Reflect on the sprint
+2. Identify improvements
+3. Create action items
+
+### Formats
+
+#### Start/Stop/Continue
+```
+🟢 START doing: [What new things should we try?]
+🔴 STOP doing: [What's not working?]
+🔵 CONTINUE doing: [What's working well?]
+```
+
+#### 4Ls
+```
+😍 LIKED: [What did you like?]
+📚 LEARNED: [What did you learn?]
+😕 LACKED: [What was missing?]
+🔮 LONGED FOR: [What do you wish for?]
+```
+
+#### Sailboat
+```
+⛵ WIND (helps us): [What's pushing us forward?]
+⚓ ANCHOR (slows us): [What's holding us back?]
+🪨 ROCKS (risks): [What dangers are ahead?]
+🏝️ ISLAND (goal): [Where do we want to go?]
+```
+
+### Facilitation Tips
+- Safe space - no blame
+- Everyone participates
+- Time-box discussions
+- Vote on top items
+- Limit action items (2-3)
+- Follow up next retro
+
+---
+
+## Backlog Refinement
+
+### Objectives
+1. Clarify upcoming stories
+2. Estimate stories
+3. Break down large items
+
+### Agenda
+
+```markdown
+## Refinement Agenda (1 hour)
+
+1. **Review Action Items** (5 min)
+   - From last refinement
+
+2. **Epic Review** (10 min)
+   - Status of in-flight epics
+   - Upcoming epics overview
+
+3. **Story Refinement** (40 min)
+   - Review 3-5 stories
+   - Clarify requirements
+   - Add acceptance criteria
+   - Estimate (story points)
+
+4. **Wrap Up** (5 min)
+   - Action items
+   - Stories ready for sprint
+```
+
+### Definition of Ready
+
+Story is ready when:
+- [ ] Clearly written with user perspective
+- [ ] Acceptance criteria defined
+- [ ] Estimated by team
+- [ ] Dependencies identified
+- [ ] Small enough for one sprint
+- [ ] Testable
+
+---
+
+## Estimation Techniques
+
+### Planning Poker
+
+| Points | Meaning |
+|--------|---------|
+| 1 | Trivial |
+| 2 | Simple |
+| 3 | Moderate |
+| 5 | Complex |
+| 8 | Very Complex |
+| 13 | Epic-sized (split it) |
+
+### T-Shirt Sizing
+
+| Size | Relative Effort |
+|------|-----------------|
+| XS | Hours |
+| S | 1-2 days |
+| M | 3-5 days |
+| L | 1-2 weeks |
+| XL | Needs breakdown |
+
+---
+
+## Remote Ceremony Tips
+
+### Tools
+- Video: Zoom, Teams
+- Board: Miro, Mural
+- Voting: Mentimeter
+- Timer: Online stopwatch
+
+### Best Practices
+- Camera on for engagement
+- Use virtual whiteboard
+- More breaks for longer sessions
+- Async pre-work reduces time
+- Clear facilitation hand-offs
+- Record for absent members
+
+---
+
+## Ceremony Health Check
+
+### Sprint Planning
+- [ ] Sprint goal is clear
+- [ ] Team has capacity
+- [ ] Stories are refined
+- [ ] Commitment is realistic
+
+### Daily Standup
+- [ ] Starts on time
+- [ ] Finishes in 15 min
+- [ ] Blockers are raised
+- [ ] Team is engaged
+
+### Sprint Review
+- [ ] Working software shown
+- [ ] Stakeholders present
+- [ ] Feedback captured
+- [ ] Team celebrated
+
+### Retrospective
+- [ ] Safe environment
+- [ ] Everyone participated
+- [ ] Actions are specific
+- [ ] Previous actions reviewed