From 2a161f6f3eb20d35f3bbd878ce400682a143534a Mon Sep 17 00:00:00 2001 From: happybell80 Date: Tue, 10 Mar 2026 19:54:41 +0900 Subject: [PATCH] docs: add runtime principles --- .../01_PRINCIPLES/Runtime_Principles.md | 25 +++++++++++++++++++ README.md | 9 ++++--- 2 files changed, 30 insertions(+), 4 deletions(-) create mode 100644 00_Philosophy/01_PRINCIPLES/Runtime_Principles.md diff --git a/00_Philosophy/01_PRINCIPLES/Runtime_Principles.md b/00_Philosophy/01_PRINCIPLES/Runtime_Principles.md new file mode 100644 index 0000000..230ac8f --- /dev/null +++ b/00_Philosophy/01_PRINCIPLES/Runtime_Principles.md @@ -0,0 +1,25 @@ +# Runtime Principles + +## 1. Runtime Must Be Derived +- 런타임은 기준 문서와 Git 관리본에서 파생되어야 한다. +- `/etc`, 컨테이너 내부 설정, 서버 로컬 오버라이드는 기준이 아니라 산출물이다. + +## 2. Direct Runtime Editing Creates Hidden State +- 실행본을 직접 고치면 구조보다 상태가 앞서기 시작한다. +- 이런 변경은 다음 장애 때 원인보다 흔적으로 먼저 발견되므로, 원칙적으로 금지한다. + +## 3. Temporary Overrides Become Permanent Debt +- `.env`, failover 값, 임시 IP, 임시 upstream은 시간이 지나면 거의 항상 active 원인 경로가 된다. +- 임시값은 존재 자체가 예외여야 하며, 제거 조건 없이 남아 있으면 장애의 선행 징후로 본다. + +## 4. Drift Is a Runtime Failure +- Git 관리본과 실제 실행본이 다르면 문서 불일치가 아니라 런타임 실패다. +- 특히 nginx, env, upstream, mount, deploy 경로는 "둘 다 맞을 수 없다"는 전제로 다룬다. + +## 5. Runtime Truth Comes From the Loaded Path +- 설정의 진실은 저장된 파일이 아니라 실제 로드된 경로에서 판단한다. +- 설명, 백업본, 옛 파일명이 아니라 현재 프로세스가 읽는 설정만 기준으로 삼는다. + +## 6. Changes Close Only After Reproduction +- 런타임 변경은 파일 수정으로 닫히지 않는다. +- 실제 프로세스 재기동, 로드 경로 확인, 실호출 검증까지 끝나야 반영된 것으로 본다. diff --git a/README.md b/README.md index ee707ed..c555cf9 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,8 @@ 2. [00_Philosophy/00_IDENTITY/Infra_Project_Identity.md](./00_Philosophy/00_IDENTITY/Infra_Project_Identity.md) 3. [00_Philosophy/01_PRINCIPLES/Core_Infrastructure_Principles.md](./00_Philosophy/01_PRINCIPLES/Core_Infrastructure_Principles.md) 4. [00_Philosophy/01_PRINCIPLES/Network_Principles.md](./00_Philosophy/01_PRINCIPLES/Network_Principles.md) -5. [00_Philosophy/02_GUARDRAILS/Operational_Guardrails.md](./00_Philosophy/02_GUARDRAILS/Operational_Guardrails.md) -6. [02_Architecture/Infrastructure_Project_Structure.md](./02_Architecture/Infrastructure_Project_Structure.md) -7. [journey/research/260307_value_기준_인프라철학문서_구조초안.md](./journey/research/260307_value_기준_인프라철학문서_구조초안.md) -8. [journey/README.md](./journey/README.md) +5. [00_Philosophy/01_PRINCIPLES/Runtime_Principles.md](./00_Philosophy/01_PRINCIPLES/Runtime_Principles.md) +6. [00_Philosophy/02_GUARDRAILS/Operational_Guardrails.md](./00_Philosophy/02_GUARDRAILS/Operational_Guardrails.md) +7. [02_Architecture/Infrastructure_Project_Structure.md](./02_Architecture/Infrastructure_Project_Structure.md) +8. [journey/research/260307_value_기준_인프라철학문서_구조초안.md](./journey/research/260307_value_기준_인프라철학문서_구조초안.md) +9. [journey/README.md](./journey/README.md)