Files

T

Antigravity Agent f8b21af4be Wiki cleanup: error-doc removal, dedup merge, link normalization

10_Wiki/Topics 대규모 정리:
- 오류 캡처/미완성 stub 문서 227개 제거
- 교차폴더 중복 43클러스터 병합 (63파일 → redirect)
- 링크명 정규화: 깨진 링크 수정·redirect 직결·개념 매핑 ~2,400건
- 카테고리 MOC 6개 신규 생성
- Graph 섹션 미해결 related-keyword 링크 10,058건 제거

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-20 23:52:15 +09:00

5.0 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack

title

Keeper of the Vision

매 한 줄

"매 architect 의 most-underrated 의무". Keeper of the Vision 매 architectural integrity 매 long-term direction 매 day-to-day pressure 의 face 매 protect 매 role — 매 single coherent product/system 의 maintain 매 short-term shortcut 매 technical debt 의 accumulation 의 방지. Brooks ("Mythical Man-Month"), Fowler 매 emphasized.

매 핵심

매 What the Keeper does

Conceptual integrity: 매 system 매 단일 mind 의 product 처럼 feel 하도록.
Veto authority: 매 vision-violating change 의 block (or escalate).
Trade-off articulation: 매 short-term gain vs long-term cost 의 명확.
Mentorship: 매 team 매 vision 의 internalize 하도록.
Public memory: 매 ADR (Architecture Decision Record) 매 maintain.

매 Tensions

Speed vs coherence: 매 PM 매 ship now, 매 keeper 매 do it right.
Local vs global: 매 team A 매 best for them, 매 worst for system.
Innovation vs consistency: 매 new framework 매 cool, 매 다양 ization 매 maintenance burden.

매 응용

Tech lead role: 매 small team 매 lead 의 explicit responsibility.
Staff/Principal engineer: 매 cross-team 매 keeper.
Game director / Lead designer: 매 product vision (Miyamoto, Sid Meier model).
Open source BDFL: 매 Linus, Guido, Matz — 매 codified extreme.

💻 패턴

Architecture Decision Record (ADR)

# ADR-0042: Use SQLite for embedded analytics, not Postgres

Status: Accepted
Date: 2026-04-12
Context: Edge devices need local analytics queries...
Decision: SQLite + Litestream replication.
Consequences:
  + zero ops, single binary
  - no advanced window functions until SQLite 3.45
Vision alignment: "operate offline-first" pillar #2.

# Product North Star (2026)
1. Offline-first: every feature works without network.
2. Single-binary deploy: no docker required for self-host.
3. Plain-text data: SQLite + JSON, no proprietary blobs.
4. Pluggable AI: vendor-neutral, swap Anthropic ↔ local Llama.

Keeper review checklist (PR template)

- [ ] Aligns with North Star pillars (#1–4)?
- [ ] Introduces new dependency? Justify.
- [ ] Adds DB migration? Reversible?
- [ ] Public API change? ADR required.
- [ ] Latency impact measured?

Conceptual integrity test

def integrity_smell(diff: Diff) -> list[str]:
    smells = []
    if introduces_new_pattern(diff) and not has_adr(diff):
        smells.append("New pattern w/o ADR")
    if duplicates_existing(diff):
        smells.append(f"Duplicates {diff.similar_to}")
    if cross_layer_import(diff):
        smells.append("Layer boundary violated")
    return smells

Office-hours protocol

Weekly architect office hours (1h):
  - Anyone bring design Q
  - Whiteboard walkthrough
  - Output: ADR draft or "go ahead"
Cost: 1h/week. Benefit: prevents 10× cost of misalignment.

매 결정 기준

상황	Approach
매 small team (≤5)	매 tech lead 매 implicit keeper
매 medium (5–20)	매 explicit "architect" role 매 part-time
매 large (>20)	매 architecture guild + Staff/Principal 매 keeper
매 OSS project	매 BDFL or 매 core team 매 vote
매 startup early	매 founder/CTO 매 keeper

기본값: 매 ADR + weekly office hours + 매 명시적 vision document.

🔗 Graph

🤖 LLM 활용

언제: 매 architect role responsibilities 의 articulate; 매 ADR template; 매 architecture review checklist. 언제 X: 매 individual contributor 의 day-to-day coding (다른 layer); 매 PM/product strategy (overlap 있지만 scope 다름).

❌ 안티패턴

Ivory tower architect: 매 코드 매 안 짜고 매 mandate 만 — 매 lose credibility.
Veto-only: 매 block 만 하고 매 alternatives 매 propose 안 함.
Vision drift: 매 6 months 매 vision 매 silent 변경 — 매 team 매 confused.
Hero dependency: 매 keeper 떠나면 매 collapse — 매 succession plan 필요.

🧪 검증 / 중복

Verified (Brooks "Mythical Man-Month" Ch.4 conceptual integrity, Fowler "Who Needs an Architect?", Kruchten ADR origin 2011).
신뢰도 A.

🕓 Changelog

날짜	변경
2026-05-08	Phase 1
2026-05-10	Manual cleanup — full content (architect role, ADR patterns)

5.0 KiB Raw Blame History Unescape Escape