feat: add kord_routine workflow and remove voice master environment variables from example configuration.

This commit is contained in:
이정수 2026-03-27 09:53:32 +09:00
parent da47c4b140
commit b8c18cfefe
2 changed files with 32 additions and 5 deletions

View File

@ -0,0 +1,31 @@
---
description: Kord 프로젝트 개발 및 테스트 작업 루틴
---
# Kord Discord Bot Development Routine & Rules
이 워크플로우는 Kord 프로젝트의 기능 개발 및 테스트 표준 절차를 정의합니다. Kord와 관련된 모든 작업 지시를 받을 때 다음 규칙과 절차를 반드시 따르십시오.
## 기본 원칙 (Work Rules)
1. **인프라 자율 사용**: 에이전트는 프로젝트에 설정된 Docker 기반 인프라(PostgreSQL, Redis 등)를 사용자의 추가 승인 없이 자유롭게 구동(`docker-compose up -d`) 및 활용할 수 있습니다.
2. **협력적 기획, 독립적 실행**: 기능 기획과 설계(Architecture, Schema 등)는 사용자와 함께 논의하고 피드백을 반영합니다. 기획이 승인된 후 진행되는 코드 작성, 에러 디버깅, 자체 테스트는 별도 질문 없이 에이전트가 주도적으로 끝마칩니다.
## 단계별 작업 루틴
### 1단계: 기획 및 설계 (Planning Phase)
- 사용자가 새로운 기능이나 수정 사항을 요청하면, 필요한 스펙 및 예외 사항을 꼼꼼히 확인합니다.
- 변경 사항, 사용 스택, 아키텍처를 포함한 `implementation_plan.md`를 작성하거나 업데이트하여 사용자에게 검토 및 승인을 요청합니다.
### 2단계: 개발 및 구현 (Execution Phase)
- 설계가 승인되면 코딩을 시작합니다.
- 환경 변수 파싱, 로깅, 예외 처리를 철저히 포함하여 프로덕션 수준의 코드를 작성합니다.
### 3단계: 자체 구동 및 내부 테스트 (Internal Testing Phase)
- 사용자가 최종 테스트를 하기 전에 **에이전트 스스로 봇이 모순이나 심각한 에러 없이 구동 가능한지 확인**해야 합니다.
- 필요하다면 단위 테스트(`yarn test`)를 실행합니다.
- 인프라(DB/Cache)를 연결하고 로컬에서 봇을 시험 가동하여 TypeScript 컴파일 에러나 런타임 초기화 에러가 없는지 완벽하게 점검합니다.
- 오류 발생 시 자체적으로 판단하고 디버깅하여 해결합니다.
### 4단계: 사용자 최종 테스트 지원 (Final Manual Testing)
- 내/외부 테스트를 거쳐 정상 구동이 확정된 버전을 사용자에게 보고합니다.
- 사용자는 실질적으로 자신의 디스코드 서버에 봇을 초대하여 인게임/인앱 시나리오를 수동 테스트합니다.
- **사후 검토**: 이 과정에서 사용자가 버그나 오류를 보고할 경우, 에이전트는 로컬 터미널의 로그(Log)나 DB의 상태를 검토(조회 명령어 사용 등)하여 무엇이 문제였는지 면밀히 파악하고 수정안을 제시해야 합니다.

View File

@ -8,8 +8,4 @@ DATABASE_URL="postgresql://kord:password@localhost:5432/kord_db?schema=public"
# Redis Configuration # Redis Configuration
REDIS_HOST="localhost" REDIS_HOST="localhost"
REDIS_PORT=6379 REDIS_PORT=6379
# Voice Master
VOICE_WAITING_ROOM_ID=your_waiting_room_channel_id
VOICE_CATEGORY_ID=your_category_id_where_channels_are_created