45f96176a6
- CLAUDE.md: project context and architecture spec - docs/: system specs, DB schema, messenger integration, deployment engine - skills/: guardia-deploy, guardia-agent, guardia-messenger - .claude/settings.json: project-level permissions - .gitignore: Python/FastAPI project Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
89 lines
3.7 KiB
Markdown
89 lines
3.7 KiB
Markdown
# GUARDiA — AI 기반 레거시 인프라 자율 운영 플랫폼
|
|
|
|
> **Claude Code용 프로젝트 마스터 컨텍스트 파일**
|
|
> 이 파일을 읽고 프로젝트의 전체 구조와 규칙을 파악한 뒤 작업을 시작하라.
|
|
|
|
---
|
|
|
|
## 프로젝트 비전
|
|
|
|
1,000개 이상의 다중 관공서(Multi-tenant) 레거시 인프라를 타겟으로 하는
|
|
**AI 기반 통합 ChatOps 오케스트레이션 플랫폼**.
|
|
|
|
- 메신저 한 줄 명령 → sLLM 파싱 → 에이전트리스(SSH/SFTP) 배포·운영 자동화
|
|
- 에이전트 설치 **불필요** — 표준 SSH/FTP 프로토콜만 활용
|
|
- 개발(Dev), SM 운영, PM 관리 세 역할의 워크플로우를 단일 메신저로 통합
|
|
|
|
---
|
|
|
|
## 디렉터리 구조
|
|
|
|
```
|
|
C:\GUARDiA\
|
|
├── CLAUDE.md # ← 지금 이 파일 (Claude Code 진입점)
|
|
├── docs/
|
|
│ ├── system_spec.md # 전체 시스템 아키텍처 명세
|
|
│ ├── ai_orchestration.md # AI 에이전트 워크플로우 규격
|
|
│ ├── db_schema.md # CMDB + SR + Audit 테이블 DDL
|
|
│ ├── messenger_integration.md # 메신저 웹훅 & sLLM 연동 명세
|
|
│ ├── deployment_engine.md # 에이전트리스 배포 엔진 명세
|
|
│ ├── security_governance.md # 보안·권한·감사 정책
|
|
│ └── shell_scripts_guide.md # SM용 원격 제어 쉘 스크립트 가이드
|
|
├── skills/
|
|
│ ├── guardia-deploy/SKILL.md # 배포 엔진 구현 스킬
|
|
│ ├── guardia-agent/SKILL.md # Python 역방향 에이전트 스킬
|
|
│ └── guardia-messenger/SKILL.md # 메신저 연동 스킬
|
|
└── src/ (생성 예정)
|
|
├── api/ # FastAPI 백엔드
|
|
├── agent/ # Python 역방향 에이전트
|
|
├── llm/ # sLLM 파서 모듈
|
|
├── deploy/ # SSH/SFTP 배포 엔진
|
|
└── db/ # DB 마이그레이션 & 모델
|
|
```
|
|
|
|
---
|
|
|
|
## 기술 스택 (변경 금지)
|
|
|
|
| 레이어 | 기술 | 비고 |
|
|
|--------|------|------|
|
|
| Backend API | Python 3.11+ / FastAPI | 비동기 WebSocket 처리 |
|
|
| LLM | 온프레미스 sLLM (Llama-3-8B / Solar-10.7B) | **외부 API 호출 절대 금지** |
|
|
| Infra 연결 | `paramiko` (SSH/SFTP) | 에이전트리스 |
|
|
| Database | PostgreSQL (CMDB + SR + Audit) | |
|
|
| 배포 자동화 | 쉘 스크립트 + Ansible (선택) | |
|
|
| 프론트 | React.js 또는 HTML5/Vanilla JS | |
|
|
|
|
---
|
|
|
|
## 핵심 구현 원칙
|
|
|
|
1. **에이전트리스**: 대상 서버에 어떤 소프트웨어도 설치하지 않는다.
|
|
2. **결정론적 파싱**: sLLM은 JSON만 출력한다. 자연어 부연 설명 금지.
|
|
3. **Fail-Safe**: 모든 배포는 백업 → 배포 → 헬스체크 → 롤백 시퀀스를 따른다.
|
|
4. **감사 추적**: 모든 명령과 결과는 `TB_AUDIT_LOG`에 기록한다.
|
|
5. **최소 권한**: 관제 전용 일반 계정(opsagent) 사용. root SSH 직접 접속 금지.
|
|
6. **보안 우선**: 서버 자격증명은 암호화 DB에만 저장. 메신저 응답에 노출 금지.
|
|
|
|
---
|
|
|
|
## 작업 시작 순서 (권장)
|
|
|
|
```
|
|
1단계: docs/db_schema.md 읽기 → PostgreSQL DDL 작성
|
|
2단계: docs/messenger_integration.md 읽기 → FastAPI 웹훅 서버 구현
|
|
3단계: docs/deployment_engine.md 읽기 → SSH/SFTP 배포 엔진 구현
|
|
4단계: docs/ai_orchestration.md 읽기 → sLLM 파서 & 워크플로우 연동
|
|
5단계: docs/security_governance.md 읽기 → 권한 검증 & 감사 모듈 구현
|
|
```
|
|
|
|
---
|
|
|
|
## 스킬 파일 참조 방법
|
|
|
|
특정 기능 구현 전 해당 스킬 파일을 반드시 먼저 읽어라.
|
|
|
|
- 배포 엔진 작업 시 → `skills/guardia-deploy/SKILL.md`
|
|
- 역방향 에이전트 작업 시 → `skills/guardia-agent/SKILL.md`
|
|
- 메신저 연동 작업 시 → `skills/guardia-messenger/SKILL.md`
|