Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-database

hyper-database

Verified

[Hyper] Use this skill when the user asks for database work - designing a data model or schema, reviewing or writing migrations, tuning slow queries and indexes, choosing an engine, or DBA operations such as backup and restore, replication and failover, connection pooling, security, upgrades, and monitoring - on PostgreSQL, MySQL or MariaDB, SQLite, Redis, Valkey, MongoDB, DynamoDB, Cassandra or ScyllaDB, or distributed and serverless SQL. It detects the engines from repository files, applies the matching engine guide bundled in this skill, and saves a report under `.hyper/database/[slug]/`. Do not use it for application code that changes no schema, query, index, or database setting.

references/report-template.ko.md

View on GitHub
# 보고서 템플릿

`.hyper/database/<slug>/report.md`를 쓸 때 이 참조를 사용합니다. 보고서는 한국어로 쓰고, SQL, 명령, 식별자, 규칙 ID는 영어로 둡니다. 아래 모드 표가 선택 사항으로 표시하고 내용이 없는 절만 생략합니다. 필수 절은 삭제하지 말고 `해당 없음`이라고 씁니다.

## 절 행렬

| Section | design | review | change | tune | operate | choose |
|---|---|---|---|---|---|---|
| 1. 요약 | required | required | required | required | required | required |
| 2. 감지 근거 | required | required | required | required | required | optional |
| 3. 입력과 가정 | required | optional | required | required | required | required |
| 4. 발견 사항 | optional | required | required | required | required | optional |
| 5. 설계 또는 변경 | required | - | required | required | required | - |
| 6. 비교와 권고 | optional | - | - | - | - | required |
| 7. 운영 영향 | required | optional | required | optional | required | required |
| 8. 검증 | required | required | required | required | required | optional |
| 9. 남은 위험과 다음 단계 | required | required | required | required | required | required |

## 템플릿

````markdown
# <작업 제목>

- 모드: design | review | change | tune | operate | choose
- 대상: <저장소 경로, 패키지, 데이터베이스 이름(값 없이)>
- 기준일: YYYY-MM-DD

## 1. 요약

<결론 세 줄 이내: 무엇을 판단했고, 무엇을 바꿨고, 가장 큰 위험은 무엇인가>

## 2. 감지 근거

| 엔진 | 근거 파일 | 신호 | 적용 가이드 |
|---|---|---|---|
| postgres | drizzle.config.ts | `dialect: 'postgresql'` | engines/postgres.md |

## 3. 입력과 가정

| 접근 패턴 | 읽기/쓰기 | 조건·정렬 | 빈도 | 담당 키·인덱스 |
|---|---|---|---|---|
| 사용자별 최근 주문 20개 | 읽기 | `user_id =`, `created_at desc` | 초당 300 | `orders (user_id, created_at desc)` |

- 데이터 규모: <현재 행·항목 수, 일 증가량, 보존 기간>
- 불변 조건: <깨지면 안 되는 규칙>
- 가정: <사용자 답이 없어 정한 값과 그 이유>

## 4. 발견 사항

| ID | 심각도 | 위치 | 근거 | 수정 |
|---|---|---|---|---|
| PG-IDX-01 | high | `migrations/0042.sql:7` | `CREATE INDEX`가 `CONCURRENTLY` 없이 1억 행 테이블에 걸림 | `CREATE INDEX CONCURRENTLY`로 분리, 트랜잭션 밖에서 실행 |

## 5. 설계 또는 변경

<스키마·키 배치·마이그레이션 단계. 단계마다 잠금, 소요 시간, 되돌리는 방법>

## 6. 비교와 권고

| 기준 | 후보 A | 후보 B |
|---|---|---|

- 권고: <선택과 이유>
- 판단을 바꿀 근거: <어떤 사실이 나오면 다른 선택이 맞는가>

## 7. 운영 영향

- 백업·복구: <방식, RPO/RTO, 복구 시험 여부>
- 용량: <저장 공간·메모리·IOPS 추정과 공식>
- 보안: <역할, 권한, 암호화, 개인정보>
- 모니터링: <지표와 경보 기준>

## 8. 검증

| 확인 | 명령·방법 | 결과 | 출처 파일 |
|---|---|---|---|
| 인덱스 사용 | `EXPLAIN (ANALYZE, BUFFERS) ...` (일회용 DB, 100만 행) | Index Scan, 412ms -> 3ms | plan-after.txt |
| 복구 시험 | - | not run: 백업 접근 권한 없음 | - |

## 9. 남은 위험과 다음 단계

- <위험과 그 결과, 담당, 다음 행동>
````

## 규칙

- 모든 숫자가 계보를 밝힙니다. `측정`(명령 포함), `추정`(공식 포함), `사용자 제공`입니다.
- 실행 계획, 린터 출력, 감지기 JSON은 보고서 옆에 파일로 두고 링크하며, 전문을 붙여 넣지 않습니다.
- 연결 문자열, 비밀번호, 토큰, 고객 행은 `<redacted>`로 가립니다.

## Sources

> Checked 2026-11-07.

| Claim | Source |
|---|---|
| 절 집합과 모드 행렬 | 이 패키지가 고른 설계이며 검증된 최적값이 아님 |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall