docs: broken links 수정 + PR 템플릿 + 외부 참조 ADR 경로 갱신#6
Merged
Conversation
본 세션의 ADR 정리 후속으로 누적 부채 정리.
1. Broken links 수정 (4개):
- README.md: docs/superpowers/specs/.../backup-management-design.md (사라진 경로)
→ docker/backup/README.md + k8s/infra/prod/backup/README.md
- analytics/CLAUDE.md, experiment/CLAUDE.md: docs/service.md (없는 파일)
→ 실제 존재하는 ADR / common 모듈 링크로 교체
- docs/specs/.../seven-split-phase1-release-notes.md: 잘못된 상대 경로
../../adr/ → ../../../adr/
2. PR 템플릿 신설 (.github/PULL_REQUEST_TEMPLATE.md):
- ADR-0026 분류 체크박스 (ADR / Conventions / Standards / 분류 불필요)
- ADR-0025 Latency Budget Impact 체크박스 (Tier / 자릿수 / fan-out / 외부 호출 / 캐시 / 측정)
- 일반 Test Plan + Checklist
3. 외부 참조 옛 ADR 경로 일괄 갱신 (sed 일괄):
- docs/specs, docs/portfolio, docs/benchmarks 의 6개 ADR 경로
- ADR-0014/0016/0020/0021/0022/0023 → conventions/ 또는 standards/ 새 위치
- ADR 디렉토리 자체 (redirect 의 의도적 옛 경로 참조) 와 study/ 는 제외
4. .gitignore 에 private/ 추가 (개인 작업 디렉토리 소음 제거)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1989v
added a commit
that referenced
this pull request
May 2, 2026
신규 5 주제 (#14 CRDT/MRDT, #15 Connection Pool, #16 Async/NIO, #17 Spring Web, #18 gRPC) plan + deep file 약 100개. 기존 10 주제 (#2 JVM, #3 동시성, #4 DB, #5 Spring TX, #6 Kafka, #7 분산시스템, #8 시스템 설계, #9 Redis, #10 Observability, #11 K8s) deep file 일괄 추가. 흡수 처리: - 17-1 readOnly/writable TX → #5에 흡수 (06-readonly-vs-writable + 07-replica-routing-pattern) - 17-3 스레드 덤프 → #3에 흡수 (20-thread-dump-analysis dedicated) - 17-3 cross-ref → #2 (13-heap-dump-mat 섹션 7) 메타 산출물 5종: - study/docs/00-INDEX.md (660줄, 18 주제 entry + 의존 그래프 + 키워드 인덱스) - study/docs/00-INTERVIEW-INDEX.md (1028줄, ~730 카드 통합 + 모의 시나리오 5개) - study/docs/00-LEARNING-GUIDE.md (817줄, 3개월/6개월/9개월 트랙 + 1/2/3회독) - study/docs/00-ADR-CANDIDATES.md (1564줄, 34 ADR 후보 + OP 25 + 10스프린트 로드맵) - study/CLAUDE.md (155줄, study 영역 navigation) 기타 갱신: - 11 plan.md frontmatter status: completed (2026-05-02) - temp.md 학습 현황표 18 주제 모두 'completed + N deep files' - 루트 CLAUDE.md Navigation 에 study/ 영역 entry 총 18 주제 / 333 deep files / ~97K 줄 + 메타 ~4.2K 줄. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1989v
added a commit
that referenced
this pull request
May 3, 2026
docs: broken links 수정 + PR 템플릿 + 외부 참조 ADR 경로 갱신
1989v
added a commit
that referenced
this pull request
May 3, 2026
신규 5 주제 (#14 CRDT/MRDT, #15 Connection Pool, #16 Async/NIO, #17 Spring Web, #18 gRPC) plan + deep file 약 100개. 기존 10 주제 (#2 JVM, #3 동시성, #4 DB, #5 Spring TX, #6 Kafka, #7 분산시스템, #8 시스템 설계, #9 Redis, #10 Observability, #11 K8s) deep file 일괄 추가. 흡수 처리: - 17-1 readOnly/writable TX → #5에 흡수 (06-readonly-vs-writable + 07-replica-routing-pattern) - 17-3 스레드 덤프 → #3에 흡수 (20-thread-dump-analysis dedicated) - 17-3 cross-ref → #2 (13-heap-dump-mat 섹션 7) 메타 산출물 5종: - study/docs/00-INDEX.md (660줄, 18 주제 entry + 의존 그래프 + 키워드 인덱스) - study/docs/00-INTERVIEW-INDEX.md (1028줄, ~730 카드 통합 + 모의 시나리오 5개) - study/docs/00-LEARNING-GUIDE.md (817줄, 3개월/6개월/9개월 트랙 + 1/2/3회독) - study/docs/00-ADR-CANDIDATES.md (1564줄, 34 ADR 후보 + OP 25 + 10스프린트 로드맵) - study/CLAUDE.md (155줄, study 영역 navigation) 기타 갱신: - 11 plan.md frontmatter status: completed (2026-05-02) - temp.md 학습 현황표 18 주제 모두 'completed + N deep files' - 루트 CLAUDE.md Navigation 에 study/ 영역 entry 총 18 주제 / 333 deep files / ~97K 줄 + 메타 ~4.2K 줄. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1989v
added a commit
that referenced
this pull request
May 3, 2026
docs: broken links 수정 + PR 템플릿 + 외부 참조 ADR 경로 갱신
1989v
added a commit
that referenced
this pull request
May 3, 2026
신규 5 주제 (#14 CRDT/MRDT, #15 Connection Pool, #16 Async/NIO, #17 Spring Web, #18 gRPC) plan + deep file 약 100개. 기존 10 주제 (#2 JVM, #3 동시성, #4 DB, #5 Spring TX, #6 Kafka, #7 분산시스템, #8 시스템 설계, #9 Redis, #10 Observability, #11 K8s) deep file 일괄 추가. 흡수 처리: - 17-1 readOnly/writable TX → #5에 흡수 (06-readonly-vs-writable + 07-replica-routing-pattern) - 17-3 스레드 덤프 → #3에 흡수 (20-thread-dump-analysis dedicated) - 17-3 cross-ref → #2 (13-heap-dump-mat 섹션 7) 메타 산출물 5종: - study/docs/00-INDEX.md (660줄, 18 주제 entry + 의존 그래프 + 키워드 인덱스) - study/docs/00-INTERVIEW-INDEX.md (1028줄, ~730 카드 통합 + 모의 시나리오 5개) - study/docs/00-LEARNING-GUIDE.md (817줄, 3개월/6개월/9개월 트랙 + 1/2/3회독) - study/docs/00-ADR-CANDIDATES.md (1564줄, 34 ADR 후보 + OP 25 + 10스프린트 로드맵) - study/CLAUDE.md (155줄, study 영역 navigation) 기타 갱신: - 11 plan.md frontmatter status: completed (2026-05-02) - temp.md 학습 현황표 18 주제 모두 'completed + N deep files' - 루트 CLAUDE.md Navigation 에 study/ 영역 entry 총 18 주제 / 333 deep files / ~97K 줄 + 메타 ~4.2K 줄. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1989v
added a commit
that referenced
this pull request
May 4, 2026
19-search-engine 의 99-catalog 패턴을 다른 18개 학습 주제로 확장. 각 catalog 는 공식 reference (Apache/JDK/IETF/RFC/cloud docs) 기준: - §1 기존 deep file 매트릭스 + 갭 진단 - §2 카테고리별 개념 트리 (✅ 커버 / 🟡 부분 / ★ 신규 / skip) - §3 우선 심화 후보 Top-N - §4 표준 deep-dive 템플릿 (19/99 §4 재사용) - §5 참고 자료 특징: - #1 AWS — VPC/PrivateLink/TGW/Route53/Network Firewall/Global Accelerator/IPAM - #2 JVM — JDK 21+ Generational ZGC/CRaC/Leyden/Lilliput/JEP 트래커 - #3 동시성 — Loom Structured Concurrency/Scoped Values/VarHandle/Flow operators - #4 DB — Window/CTE/Generated columns/Partitioning/PG MVCC/Replication - #5 Spring TX — REQUIRES_NEW connection 점유/AbstractRoutingDataSource/Reactive TX - #6 Kafka — KRaft/Tiered Storage/Streams DSL/Schema Registry/Connect SMT - #7 분산 — Quorum/Gossip/Service Mesh/Saga/CRDT cross/Chaos Engineering - #8 시스템 설계 — 30+ 표준 시나리오 + 14개 핵심 의사결정 카드 - #9 Redis — Stream Consumer Group/Functions/RESP3/Client Caching/Modules - #10 Observability — OTel Collector/Continuous Profiling/eBPF/SLO Burn Rate - #11 K8s — Gateway API/KEDA/Karpenter/Cilium/ValidatingAdmissionPolicy - #12 Latency — Tail at Scale/Little's Law/HdrHistogram/CRaC/io_uring - #13 Crypto — OAuth 2.1/DPoP/PASETO/AEAD nonce/Post-Quantum (Kyber/Dilithium) - #14 CRDT — δ-CRDT/Tree CRDT (Move op)/Loro/Local-first - #15 Pool — PgBouncer/RDS Proxy/R2DBC pool/Lettuce ClusterClientOptions - #16 Async — io_uring/Reactor Context/Netty ByteBuf/Loom vs Reactive - #17 Spring Web — VirtualThread executor/ProblemDetail/HTTP Interface clients - #18 gRPC — Buf workflow/xDS/ConnectRPC/Health protocol/Service config 19-INDEX / temp.md 의 19 주제 카드에 99-catalog 표기 동기화. Phase B: 18개 catalog 합 4,180 줄 (#19 catalog 581 줄 별도) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1989v
added a commit
that referenced
this pull request
May 4, 2026
…og 67 ✅ 변환 신규 deep file 27건 (~22,000줄), 12 토픽 분야: #1 AWS Network (+2): - 20-ipv6-ipam-byoip.md (692줄) — IPv6 dual-stack / Egress-only IGW / IPAM / BYOIP / public IPv4 비용 회피 - 21-dns-dhcp-sg-deep.md (810줄) — DHCP options / DNS resolution 함정 / SG ↔ SG references / VPC Lattice #3 Concurrency (+1): - 25-virtual-thread-coroutine-deep.md (745줄) — Java 21 Virtual Thread (Loom) vs Kotlin Coroutine 심화 비교 / Pinning / structured concurrency #4 DB (+2): - 20-online-ddl-deep.md (754줄) — MySQL INSTANT/INPLACE/COPY / gh-ost / pt-online-schema-change / Postgres CONCURRENTLY - 21-deadlock-anti-patterns.md (800줄) — wait-for graph / SHOW ENGINE INNODB STATUS / SKIP LOCKED / 회피 패턴 #6 Kafka (+4): - 14-kraft-tiered-storage.md (699줄) — KRaft 4.0 / Tiered Storage S3 / Cruise Control - 15-rebalance-protocols.md (832줄) — Cooperative (KIP-429) / Static (KIP-345) / Consumer Group Protocol (KIP-848) - 16-log-compaction-tombstone.md (881줄) — Compaction / Tombstone / Mixed / KTable backing - 17-streams-api-kstream-ktable.md (762줄) — KStream/KTable/GlobalKTable / EOS V2 / DSL operators / State store #7 Distributed Systems (+2): - 21-consensus-raft-paxos.md (664줄) — FLP / Paxos / Raft / Multi-Raft / PBFT - 22-saga-compensation-deep.md (757줄) — Choreography vs Orchestration / TCC / Temporal / Outbox+Inbox #8 System Design (+4 시나리오 카드): - 14-realtime-search-autocomplete.md (450줄) — 한국어 자동완성 시스템 - 15-distributed-counter-impressions.md (473줄) — 광고 노출/클릭 카운팅 - 16-payment-idempotency.md (550줄) — 결제 멱등성 (Idempotency-Key + Outbox + Saga) - 17-iot-telemetry-pipeline.md (595줄) — IoT 텔레메트리 (MQTT + Kafka + ClickHouse + S3 cold tier) #10 Observability (+2): - 15-prometheus-internals.md (974줄) — TSDB / WAL / XOR compression / Federation / Mimir/Cortex/Thanos - 16-opentelemetry-deep.md (1,229줄) — OTel SDK / Collector / W3C Trace Context / OTLP / Sampling / Exemplar #11 K8s (+3): - 18-operator-pattern-crd.md (1,001줄) — Operator + CRD / Reconcile loop / Finalizer / msa Operator 6종 grounding - 19-gitops-argocd-flux.md (1,058줄) — Argo CD / Flux / ApplicationSet / SealedSecrets / SOPS / ESO - 20-canary-bluegreen-argo-rollouts.md (1,020줄) — Argo Rollouts / AnalysisTemplate / msa Tier 매트릭스 #12 Latency (+1): - 13-modern-hardware-latency.md (877줄) — NVMe / DDR5 / Cloud / Lambda cold start / DB / 벡터 / GPU 자릿수 #13 Crypto/JWT/SSO (+4): - 21-aead-nonce-key-derivation.md (753줄) — AEAD nonce 함정 / AES-GCM-SIV / HKDF / CSPRNG / Crypto-agility - 22-jwt-pitfalls-zero-trust.md (932줄) — alg=none CVE / 0-RTT replay / DPoP / mTLS-bound / token rotation - 23-mtls-mesh-cert-rotation.md (878줄) — mTLS mesh (Istio/Linkerd) / SPIFFE/SPIRE / OCSP / CT log - 24-post-quantum-crypto.md (771줄) — Kyber/Dilithium/SPHINCS+/Falcon / Hybrid TLS / 마이그레이션 전략 #14 CRDT (+1): - 20-crdt-types-deep.md (703줄) — G/PN-Counter / G/2P/OR-Set / LWW/MV-Register / RGA/Logoot/Treedoc / Y.js/Automerge #16 Async I/O (+1): - 20-reactor-netty-pipeline-deep.md (898줄) — Mono/Flux / Backpressure / Schedulers / Netty pipeline / WebFlux 내부 99-catalog 갱신 (12 토픽): - §1 매트릭스에 27 신규 deep file 행 추가 - ★ 신규 / 🟡 부분 → ✅ 커버 변환 67 행 (#13:19 / #6:22 / #1:9 / #11:10 / #10:21 / #4:1 / #7:5 / #14:2 / #3:5 / #16:6 / #8:2) ADR 후보 24건 추가 (00-ADR-CANDIDATES.md §12): - 즉시 8: A2 / K2 / O2 / C1 / C2 / D1 / D2 / CO1 - 분기 11: A1 / K1 / K3 / O1 / K5 / K6 / K7 / C3 / DS2 / IO1 / LN1 - 반기 3: K4 / CC1 / C4 - cross-cutting 결합 후보 3 (mTLS+Zero-Trust / Outbox+Saga / 3-pillar Observability) master 인덱스 동기화: - 00-INDEX: 12 토픽 카운트 갱신 + 합계 421 → 448 file / 123,720 → 145,358 line - 00-INTERVIEW-INDEX: 신규 ~150 카드 예상 (840 → 990) - temp.md: 전체 통계 동기화 (456 .md / 145,358 line) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1989v
added a commit
that referenced
this pull request
May 17, 2026
리뷰어 지적 10건 중 9건 반영 (docs-health 는 별도 도메인이라 제외). [HIGH] #1 submodule pointer bump 감지 누락 case 'auth/*' 만 매칭하면 'auth' (bare name, submodule pointer diff path) 가 스킵됨 → submodule-bump 가 push 한 commit 으로 이미지 재빌드 안됨. fix: 'auth|auth/*)' 'gifticon|gifticon/app/*|gifticon/domain/*)' 로 확장. [HIGH] #5 tag push 의 commit-back 위험 refs/tags/v* push 는 detached HEAD → git push to main 실패. fix: commit-back step 에 if: github.ref == 'refs/heads/main' 추가. [MEDIUM] #7 조기 종료가 실제 step 만 종료, job 안 끝남 변경 없음 step 의 exit 0 다음에도 OCIR login / yq install 등 실행됨. fix: 후속 step 들에 if: steps.changes.outputs.kustomize_services != '' 추가. [MEDIUM] #2 PR 검증 약함 — compile gate 복귀 ci.yml 에 compile-gate job 추가 — ./gradlew compileKotlin compileJava. test 는 부담 커서 제외 (images.yml 에서 jib 가 빌드 검증함). kustomize-validate 와 병렬 실행. [MEDIUM] #6 hang 방지 모든 job 에 timeout-minutes 추가: - images publish: 60m - submodule-bump: 10m - ci compile-gate: 20m - ci kustomize-validate: 5m [LOW] #10 워크플로 README 갱신 옛 build/jib-build 설명 → 현재 구현 (compile-gate + incremental images + OCIR). [LOW] #3 GitHub App token scope 재활성 v3 의 repositories: 옵션으로 msa/msa-auth/msa-gifticon 만 토큰 발급. 최소권한 원칙 + App 이 위 3개에 정확히 설치돼있어야 동작 (현재 OK). [LOW] #4 create-github-app-token v1 → v3 현재 maintenance. 사용 인자 (app-id/private-key) 동일이라 무중단 migration. (별도) #8 Argo placeholder 흐름은 이미 application.yaml + install.sh 로 처리됨. (스킵) #9 docs-health 권한은 별도 도메인 — 이번 commit 범위 외. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
본 세션의 ADR 정리 (PR #1, #3, #4, #5) 후속으로 누적된 문서 부채 정리.
변경
1. Broken Internal Links 4개 수정
README.md—docs/superpowers/specs/.../backup-management-design.md(사라진 경로) →docker/backup/README.md+k8s/infra/prod/backup/README.mdanalytics/CLAUDE.md,experiment/CLAUDE.md—docs/service.md(없는 파일) → 실제 존재하는 ADR / common 모듈 링크로 교체docs/specs/.../seven-split-phase1-release-notes.md— 잘못된 상대 경로../../adr/→../../../adr/2. PR 템플릿 신설 (
.github/PULL_REQUEST_TEMPLATE.md)→ ADR-0025 / ADR-0026 의 Open Questions 중 "PR 템플릿 추가" 충족.
3. 외부 참조 옛 ADR 경로 일괄 갱신
sed 일괄로 6개 파일 갱신:
docs/portfolio/01-architecture.md,06-testing.mddocs/specs/2026-04-24-seven-split-crypto-trading/planning/{phase1-release-notes,requirements,spec,tasks}.md대상 ADR 경로 (6개):
docs/conventions/code-convention.mddocs/standards/service-local-docs.mddocs/conventions/transactional-usage.mddocs/conventions/logging.mddocs/conventions/entity-mutation.mddocs/standards/doc-index-tracking.md4.
.gitignore에private/추가개인 작업 디렉토리 소음 제거.
Test plan
private/가 git status 에서 사라지는지알림 — 본 PR 범위 외 발견 사항
작업 중 사용자가 본 세션과 병행으로 만든 파일들 발견 (untracked):
docs/adr/ADR-0025-market-data-hub.mddocs/adr/ADR-0026-audit-log-immutability.mddocs/adr/ADR-0027-oci-vault-kek-envelope-encryption.md(충돌 없음)docs/specs/2026-04-26-seven-split-phase2-paper-trading/docs/adr/ADR-0024-seven-split-service.md의 Errata 섹션 추가 (수정됨)본 PR 에는 포함하지 않았습니다. 사용자가 직접 처리 필요 (번호 재할당 등).
🤖 Generated with Claude Code