📝 [Wiki] Dr.Kube → AI-Powered Self-Diagnostic Agent for Kubernetes

[b100to (후잌)]

[Dr.Kube] Official Wiki

KR: 이 페이지는 Dr.Kube의 비전, 기술적 방향성, 그리고 협업 방식을 정의하는 통합 문서입니다. 팀원과 외부 기여자들이 조화롭게 협업할 수 있도록 돕는 공식 가이드라인입니다.

EN: This page serves as the comprehensive documentation defining the vision, technical direction, and collaboration methods for Dr.Kube. It is an official guideline to ensure seamless collaboration between the team and external contributors.

1. 프로젝트 개요 (Project Overview)

• Purpose: 클러스터의 '다잉 메시지’을 분석해 스스로 장애를 진단하고 해결 가이드까지 제공하는 지능형 AI 에이전트 ; An autonomous AI agent that analyzes ‘dying messages’ from failing clusters to diagnose root causes and deliver actionable remediation guidelines.

• Background / Introduction (KR):

  • Kubernetes의 고질적인 문제인 장애 발생 시 MTTR(평균 복구 시간)을 단축하는 것을 목표로 합니다.
  • LangGraph 기반 추론 루프를 통해 근본 원인을 탐색하고, Slack 등 메신저로 운영자에게 즉각적인 조치 가이드라인을 제공합니다.
  • 운영자의 승인 하에 명령을 수행하여 안전성을 확보하는 Safe AI Ops 생태계를 만듭니다.

• Background / Introduction (EN):

  • Our objective is to minimize Mean Time to Recovery (MTTR), a persistent challenge in Kubernetes environments during system failures. By leveraging LangGraph-based reasoning loops, the system identifies root causes and delivers immediate remediation guidelines to operators via messaging platforms like Slack. We are building a ‘Safe AIOps’ ecosystem that ensures operational integrity by executing commands only upon explicit human-in-the-loop approval.

• Core Values:

  • e.g., Knowledge Sovereignty (지식 주권), Open Source (오픈 소스 정신), Innovation (기술 혁신)

2. 팀 구성 (The Team)

Roles and responsibilities for the member team.

이름 (Name)	ID	역할 (Role)	SNS	주요 책임 (Responsibilities - KR/EN)
팀원 A	@id_a	Team Leader	Link	로드맵 및 최종 의사결정 / Roadmap & Final decision-making
팀원 B	@id_b	Tech Lead	Link	아키텍처 및 코드 리뷰 / Architecture & Code reviews
팀원 C	@id_c	Core Dev	Link	핵심 기능 구현 / Core logic & API implementation
팀원 D	@id_d	DevOps	Link	인프라 및 CI/CD 관리 / Infrastructure & CI/CD management
팀원 E	@id_e	Writer	Link	문서화 및 커뮤니티 관리 / Documentation & Community

3. 기술 스택 (Tech Stack)

• Language: (e.g., TypeScript, Go, Python)
• Infra: (e.g., Kubernetes, Docker, Terraform)
• Communication: Discord, GitHub Issues

4. 로드맵 (Roadmap)

• Phase 1: MVP 요구사항 정의 (MVP Requirement Definition)
• Phase 2: 핵심 모듈 개발 및 알파 테스트 (Core Module Dev & Alpha Test)
• Phase 3: 글로벌 커뮤니티 공개 (Global Community Launch)

5. 참여 방법 (How to Contribute)

• Issues: 버그나 기능 제안은 GitHub Issues를 활용하세요. (Please use GitHub Issues for bug reports or feature requests.)
• PRs: 모든 Pull Request는 Tech Lead의 검토 후 병합됩니다. (All PRs will be merged after review by the Tech Lead.)
• Guide: [CONTRIBUTING.md] 파일을 참고하세요. (Please refer to the [CONTRIBUTING.md] file.)
• Discord (Official): [Dr.Kube Invite Link]
  • KR: 실시간 소통 및 기술 지원을 위한 채널입니다.
  • EN: Official channel for real-time communication and technical support.

6. 리소스 및 링크 (Resources & Links)

• GitHub Repository: [Link]
• Docs: [Architecture / API Specs]

| This is a space where knowledge is not merely consumed, but respected, sovereign, and connected—shared together with cloud industry professionals (Bros).|
| 지식이 소비되지 않고 존중·주권보장·연결되는 공간으로 클라우드 현업 전문가(Bro)와 함께 공유하고 있습니다. |