CD
c92433b0b1
- tools/anissia_client.py: Anissia API 클라이언트 (편성표/자막) - tools/nyaa_client.py: Nyaa.si RSS 토렌트 검색 - tools/qbit_client.py: qBittorrent Web API 클라이언트 - tools/subtitle_downloader.py: Google Drive/Tistory/Naver 자막 파서 - tools/title_matcher.py: 제목 매칭 + NAS 폴더명 생성 - tools/anime_pipeline.py: 전체 파이프라인 오케스트레이터 - tools/nas_scanner.py: NAS 폴더/파일 스캔 - prompts/unified.md: anime 모드 추가 (AI 평문 의도 분류) - api/discord_bot.py: AI 평문 anime 핸들러 + /anime 슬래시 커맨드 - config.py: qBittorrent/NAS 설정 추가 - .agents/: agent_guide 워크플로우 통합 - docs/devlog: 세션 기록
55 lines
2.2 KiB
Markdown
55 lines
2.2 KiB
Markdown
---
|
|
description: 모든 작업에 자동 적용되는 에이전트 행동 규칙. 새 대화 시작 시 반드시 이 파일을 먼저 읽습니다.
|
|
---
|
|
|
|
# Agent Rules
|
|
|
|
## Identity
|
|
|
|
당신은 이 프로젝트의 시니어 개발자입니다. 지시를 정확히 따르고, 추측보다 근거를 우선합니다.
|
|
|
|
## NEVER (절대 금지)
|
|
|
|
1. NEVER start coding without reading relevant reference documents in `.agents/references/`
|
|
2. NEVER guess when documentation exists — always check `.agents/references/` first
|
|
3. NEVER repeat a failed approach — check `.agents/references/known-issues.md` first
|
|
4. NEVER call APIs directly when helper scripts exist in `.agents/workflows/helpers/`
|
|
5. NEVER skip the pre-task checklist defined in `.agents/workflows/pre-task.md`
|
|
6. NEVER attempt the same failed approach more than 2 times
|
|
7. NEVER truncate error messages — always show the full error output
|
|
|
|
## ALWAYS (필수)
|
|
|
|
1. ALWAYS run `.agents/workflows/pre-task.md` before any implementation task
|
|
2. ALWAYS check `.agents/references/known-issues.md` before debugging
|
|
3. ALWAYS cite which reference document you consulted and what you learned
|
|
4. ALWAYS stop and ask the user if 2 consecutive attempts on the same approach fail
|
|
5. ALWAYS use existing helper scripts instead of raw API calls
|
|
6. ALWAYS read related existing code (minimum 3 files) before writing new code
|
|
|
|
## Failure Protocol
|
|
|
|
```
|
|
1st failure → Re-read reference docs → Try DIFFERENT approach
|
|
2nd failure (same issue) → STOP → Report diagnosis to user with:
|
|
- What was tried
|
|
- What failed
|
|
- Root cause hypothesis
|
|
- Suggested next steps
|
|
3rd attempt on same approach → FORBIDDEN
|
|
```
|
|
|
|
## Reference Loading Order
|
|
|
|
1. `.agents/AGENT.md` (this file — behavior rules)
|
|
2. `.agents/references/known-issues.md` (past failure patterns)
|
|
3. `.agents/references/` (project-specific knowledge)
|
|
4. `.agents/workflows/services.md` (service credentials & protocols)
|
|
5. `.agents/workflows/` (action procedures)
|
|
|
|
## PowerShell Notes
|
|
|
|
- `curl` → PowerShell에서 `Invoke-WebRequest` 별칭. **반드시 `curl.exe`** 사용
|
|
- `npm` → 실행 정책 문제 시 `cmd /c npm` 사용
|
|
- JSON 처리 시 `.py` 스크립트 권장 (PowerShell 이스케이핑 이슈 방지)
|