К основному содержанию
скилл CX Codex

rfc-generator — скилл для Claude Code: что делает и как установить

Скилл rfc-generator собирает RFC по техническому предложению: проблема, решение, альтернативы, риски и план внедрения по готовому шаблону, а не с чистого листа.

MIT 294 установок ★ 64 обновлён 2026-01-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add patricio0312rev/skills --skill rfc-generator -a claude-code
Открыть на GitHub

Что делает rfc-generator

Скилл берёт тему технического предложения и разворачивает её в документ RFC по фиксированному шаблону. Внутри — статус, автор, ревьюеры, даты, дальше summary, problem statement с текущими метриками и критериями успеха, proposed solution с описанием архитектуры, detailed design, alternatives considered с вердиктом по каждому варианту, tradeoffs, risks & mitigations, rollout plan по фазам, success metrics, cost analysis, open questions и timeline.

Разметка маркдауновская: таблица расходов, чек-листы по фазам, блоки кода под схему и конфиги. Пример в шаблоне разобран на переходе к read-репликам PostgreSQL.

Структуру скилл даёт, факты — нет: нагрузку, отвергнутые варианты и риски придётся приносить свои. В шаблоне остаются примерные значения автора и дат, их надо заменить до отправки на ревью.

Какие задачи решает

  • оформить техническое предложение как RFC для ревью
  • сравнить альтернативы и записать, почему каждая отклонена
  • расписать риски вместе с мерами против них
  • разложить внедрение по фазам с чек-листом
  • свести расходы и метрики успеха рядом с решением

Примеры запросов агенту

  • Напиши RFC про вынос аналитики на read-реплику: проблема, решение, альтернативы и риски.
  • Оформи это архитектурное предложение как design doc с планом внедрения по фазам.
  • Сделай RFC с расчётом расходов и метриками успеха для нового слоя кэширования.

Как установить rfc-generator

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill rfc-generator -a claude-code

2Вручную: положить файлы

~/.claude/skills/rfc-generator/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/rfc-generator/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о rfc-generator

Как установить rfc-generator в Claude Code?

Выполните npx skills add patricio0312rev/skills --skill rfc-generator -a claude-code. Файл скилла окажется по пути ~/.claude/skills/rfc-generator/SKILL.md.

Что делает rfc-generator?

Собирает RFC по вашему техническому предложению: описывает проблему, решение, альтернативы, риски и план внедрения по разделам шаблона.

Какие разделы будут в готовом RFC?

Summary, problem statement с критериями успеха, proposed solution, detailed design, alternatives considered, tradeoffs, risks & mitigations, rollout plan, success metrics, cost analysis, open questions и timeline.

Исходный текст

SKILL.md · MIT
---
name: rfc-generator
description: Generates Request for Comments documents for technical proposals including problem statement, solution design, alternatives, risks, and rollout plans. Use for "RFC", "technical proposals", "design docs", or "architecture proposals".
---

# RFC Generator

Create comprehensive technical proposals with RFCs.

## RFC Template

```markdown
# RFC-042: Implement Read Replicas for Analytics

**Status:** Draft | In Review | Accepted | Rejected | Implemented
**Author:** Alice ([email protected])
**Reviewers:** Bob, Charlie, David
**Created:** 2024-01-15
**Updated:** 2024-01-20
**Target Date:** Q1 2024

## Summary

Add PostgreSQL read replicas to separate analytical queries from transactional workload, improving database performance and enabling new analytics features.

## Problem Statement

### Current Situation

Our PostgreSQL database serves both transactional (OLTP) and analytical (OLAP) workloads:

- 1000 writes/min (checkout, orders, inventory)
- 5000 reads/min (user browsing, search)
- 500 analytics queries/min (dashboards, reports)

### Issues

1. **Performance degradation**: Analytics queries slow down transactions
2. **Resource contention**: Complex reports consume CPU/memory
3. **Blocking features**: Can't add more dashboards without impacting users
4. **Peak hour problems**: Analytics scheduled during business hours

### Impact

- Checkout p95 latency: 800ms (target: <300ms)
- Database CPU: 75% average, 95% peak
- Customer complaints about slow pages
- Product team blocked on analytics features

### Success Criteria

- Checkout latency <300ms p95
- Database CPU <50%
- Support 2x more analytics queries
- Zero impact on transactional performance

## Proposed Solution

### High-Level Design
```

┌─────────────┐
│ Primary │────────────────┐
│ (Write) │ │
└─────────────┘ │
▼
┌─────────────┐
│ Replica 1 │
│ (Read) │
└─────────────┘
▼
┌─────────────┐
│ Replica 2 │
│ (Analytics)│
└─────────────┘

````

### Architecture
1. **Primary database**: Handles all writes and critical reads
2. **Read Replica 1**: Serves user-facing read queries
3. **Read Replica 2**: Dedicated to analytics/reporting

### Routing Strategy
```typescript
const db = {
  primary: primaryConnection,
  read: replicaConnection,
  analytics: analyticsConnection,
};

// Write
await db.primary.users.create(data);

// Critical read (always fresh)
await db.primary.users.findById(id);

// Non-critical read (can be slightly stale)
await db.read.products.search(query);

// Analytics
await db.analytics.orders.aggregate(pipeline);
````

### Replication

- **Type:** Streaming replication
- **Lag:** <1 second for read replica, <5 seconds acceptable for analytics
- **Monitoring:** Alert if lag >5 seconds

## Detailed Design

### Database Configuration

```yaml
# Primary
max_connections: 200
shared_buffers: 4GB
work_mem: 16MB

# Read Replica
max_connections: 100
shared_buffers: 8GB
work_mem: 32MB

# Analytics Replica
max_connections: 50
shared_buffers: 16GB
work_mem: 64MB
```

### Connection Pooling

```typescript
const pools = {
  primary: new Pool({ max: 20, min: 5 }),
  read: new Pool({ max: 50, min: 10 }),
  analytics: new Pool({ max: 10, min: 2 }),
};
```

### Query Classification

```typescript
enum QueryType {
  WRITE = "primary",
  CRITICAL_READ = "primary",
  READ = "read",
  ANALYTICS = "analytics",
}

function route(queryType: QueryType) {
  return pools[queryType];
}
```

## Alternatives Considered

### Alternative 1: Vertical Scaling

**Approach:** Upgrade to larger database instance

- **Pros:** Simple, no code changes
- **Cons:** Expensive ($500 → $2000/month), doesn't separate workloads, still hits limits
- **Verdict:** Rejected - doesn't solve isolation problem

### Alternative 2: Separate Analytics Database

**Approach:** Copy data to dedicated analytics DB (e.g., ClickHouse)

- **Pros:** Optimal for analytics, no impact on primary
- **Cons:** Complex ETL pipeline, eventual consistency, high maintenance
- **Verdict:** Defer - consider for future if replicas insufficient

### Alternative 3: Materialized Views

**Approach:** Pre-compute analytics results

- **Pros:** Fast queries, no replicas needed
- **Cons:** Limited to known queries, maintenance overhead
- **Verdict:** Complement to replicas, not replacement

## Tradeoffs

### What We're Optimizing For

- Performance isolation
- Cost efficiency
- Quick implementation
- Operational simplicity

### What We're Sacrificing

- Slight data staleness (acceptable for analytics)
- Additional infrastructure complexity
- Higher operational costs

## Risks & Mitigations

### Risk 1: Replication Lag

**Impact:** Analytics sees stale data
**Probability:** Medium
**Mitigation:**

- Monitor lag continuously
- Alert if >5 seconds
- Document expected lag for users

### Risk 2: Configuration Complexity

**Impact:** Routing errors, performance issues
**Probability:** Low
**Mitigation:**

- Comprehensive testing
- Gradual rollout
- Easy rollback mechanism

### Risk 3: Cost Overrun

**Impact:** Budget exceeded
**Probability:** Low
**Mitigation:**

- Use smaller instance for analytics ($300/month)
- Monitor usage
- Right-size after 1 month

## Rollout Plan

### Phase 1: Setup (Week 1-2)

- [ ] Provision read replica 1
- [ ] Provision analytics replica 2
- [ ] Configure replication
- [ ] Verify lag <1 second
- [ ] Load testing

### Phase 2: Read Replica (Week 3)

- [ ] Deploy routing logic
- [ ] Route 10% search queries to replica
- [ ] Monitor errors and latency
- [ ] Ramp to 100%

### Phase 3: Analytics Migration (Week 4-5)

- [ ] Identify analytics queries
- [ ] Update dashboard queries to analytics replica
- [ ] Test reports
- [ ] Migrate all analytics

### Phase 4: Validation (Week 6)

- [ ] Measure checkout latency improvement
- [ ] Verify CPU reduction
- [ ] User acceptance testing
- [ ] Mark as complete

## Success Metrics

### Primary Goals

- ✅ Checkout latency <300ms p95 (currently 800ms)
- ✅ Primary DB CPU <50% (currently 75%)
- ✅ Zero errors from replication lag

### Secondary Goals

- Support 2x analytics queries
- Enable new dashboard features
- Team satisfaction survey >8/10

## Cost Analysis

| Component         | Current     | Proposed      | Delta        |
| ----------------- | ----------- | ------------- | ------------ |
| Primary DB        | $500/mo     | $500/mo       | $0           |
| Read Replica      | -           | $500/mo       | +$500        |
| Analytics Replica | -           | $300/mo       | +$300        |
| **Total**         | **$500/mo** | **$1,300/mo** | **+$800/mo** |

**ROI:** Better performance enables revenue growth; analytics unlocks product insights

## Open Questions

1. What's acceptable replication lag for analytics? (Proposed: <5 sec)
2. How do we handle replica failure? (Proposed: Fallback to primary)
3. Should we add more replicas later? (Proposed: Monitor and decide in Q2)

## Timeline

- Week 1-2: Provisioning and setup
- Week 3: Read replica migration
- Week 4-5: Analytics migration
- Week 6: Validation
- **Total: 6 weeks**

## Appendix

### References

- [PostgreSQL Replication Docs](https://postgresql.org/docs/replication)
- [Cost Analysis Spreadsheet](https://docs.google.com/)
- [Load Test Results](https://example.com)

### Review History

- 2024-01-15: Initial draft (Alice)
- 2024-01-17: Added cost analysis (Bob)
- 2024-01-20: Addressed review comments

```

## RFC Process

### 1. Draft (1 week)
- Author writes RFC
- Include problem, solution, alternatives
- Share with team for early feedback

### 2. Review (1-2 weeks)
- Distribute to reviewers
- Collect comments
- Address feedback
- Iterate on design

### 3. Approval (1 week)
- Present to architecture review
- Resolve remaining concerns
- Vote: Accept/Reject
- Update status

### 4. Implementation
- Track progress
- Update RFC with learnings
- Mark as implemented

## Best Practices

1. **Clear problem**: Start with why
2. **Concrete solution**: Be specific
3. **Consider alternatives**: Show you explored options
4. **Honest tradeoffs**: Every choice has costs
5. **Measurable success**: Define done
6. **Risk mitigation**: Plan for failure
7. **Iterative**: Update based on feedback

## Output Checklist

- [ ] Problem statement
- [ ] Proposed solution with architecture
- [ ] 2+ alternatives considered
- [ ] Tradeoffs documented
- [ ] Risks with mitigations
- [ ] Rollout plan with phases
- [ ] Success metrics defined
- [ ] Cost analysis
- [ ] Timeline estimated
- [ ] Reviewers assigned
```

© patricio0312rev · MIT · patricio0312rev/skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
dev-rfc pproenca Скилл dev-rfc помогает писать технические предложения, проектные документы и архитектурные описания кодовой базы по готовым шаблонам. CX Codex +1 286установок writing-design-docs riekelt Скилл writing-design-docs для Claude Code задаёт структуру RFC и архитектурных предложений: вывод, цели и не-цели, карточки Why & What и проверку на неопределённости. CX Codex +1 26 900установок create-rfc Tech Leads Club - github.com/tech-leads-club Скилл create-rfc для Claude Code. Собирает RFC по разделам: контекст, критерии решения, варианты, итог. Фиксирует направление до начала работы. CX Codex +1 ★ 7 191звёзд репо oma-brainstorm First Fluke Скилл oma-brainstorm для Claude Code и Codex помогает проработать идею фичи до планирования и написания кода. Задаёт уточняющие вопросы по одному, сравнивает варианты реализации и фиксирует решение в документации. CX Codex +1 ★ 1 472звёзд репо design-reviewer serpro69 Субагент design-reviewer проверяет проектные спецификации и планы задач без контекста прошлых обсуждений. Помогает найти противоречия и технические риски до написания кода. CX Codex ★ 155звёзд репо technical-specification aj-geddes Скилл technical-specification для Claude Code. Помогает агенту структурировать техспеки, PRD, ADR и RFC: собирает требования, архитектуру, критерии приёмки и схемы данных в единый документ до написания кода. CX Codex +1 816установок

Из того же набора148

Весь набор →
api-mock-server Скилл api-mock-server помогает развернуть мок-сервер API для тестов и локальной разработки с помощью MSW или json-server. CX Codex +1 300установок guardrails-safety-filter-builder Скилл guardrails-safety-filter-builder собирает защитный слой для LLM-приложения: маскирует персональные данные, ловит промпт-инъекции и отвечает отказом, когда тема вне политики. CX Codex +1 299установок sql-query-optimizer Скилл sql-query-optimizer для Claude Code разбирает планы выполнения SQL, предлагает индексы и переписывает запросы. Находит причины медленных запросов. CX Codex +1 297установок dependency-vulnerability-triage Скилл dependency-vulnerability-triage для Claude Code, Codex, Cursor и других платформ преобразует результаты npm audit и Snyk в пошаговый план патчей с оценкой серьёзности, безопасными путями обновления и анализом ломающих изменений. CX Codex +1 296установок backup-restore-runbook-generator Скилл backup-restore-runbook-generator для Claude Code создаёт планы аварийного восстановления баз данных, скрипты бэкапа и проверки restore. Включает DR-планирование и подготовку процедур отката. CX Codex +1 294установок cors-configuration Скилл cors-configuration описывает настройку CORS: список источников, заголовки ответа, preflight и credentials, с готовыми примерами для Express и Next.js. CX Codex +1 294установок api-endpoint-generator Скилл api-endpoint-generator для Claude Code генерирует CRUD REST API с валидацией запросов, типами TypeScript, единым форматом ответов и документацией. Создаёт API-маршруты и backend endpoints. CX Codex +1 294установок table-builder Скилл table-builder генерирует таблицы данных на React с пагинацией, фильтрами, сортировкой и поддержкой серверного или клиентского рендеринга. CX Codex +1 293установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой