# Workspace 공통 규칙

## 절대 규칙
1. 모든 코드는 `/home/jay/workspace/` 하위에 작성
2. 테스트/검증용 임시 파일은 **pytest `tmp_path` 사용** (자동 정리됨)
3. 작업 완료 후 반드시 auto-document 기록
4. 보고서는 `/home/jay/workspace/memory/reports/` 에 저장

## QC 검증
```bash
python3 memory/code-validator.py all <파일경로>
python3 memory/red-team-auto-review.py scan <파일경로>
```

## 대시보드
```bash
python3 dashboard/server.py
# → http://localhost:8000/dashboard/
# → Tailscale: http://100.76.130.39:8000/dashboard/
```

## 모듈화 필수 규칙
1. 하드코딩 절대 금지 — 경로, ChatID, 팀명, 폰트사이즈, 색상 등 모든 설정값은 config 참조
2. config 로더 사용: `from config.loader import ConfigManager`
3. DQ 규칙 참조: `from tools.dq_rules import DQ_RULES, get_font_rule`
4. 단일 소스 목록: config/module-registry.json 확인
5. pre-commit hook이 하드코딩을 자동 차단함
6. 새로운 설정값 추가 시 반드시 module-registry.json에 등록

## 작업 완료 후 필수
```bash
python3 memory/auto-document.py log \
  --type "code" \
  --desc "작업 내용 한 줄 요약" \
  --result "success"
```

## 3문서 체계 (2유형)
- **Lv.3+ 모든 작업** → 작업 3문서 필수 (경로: `memory/plans/tasks/{task_id}/`)
- **시스템 설계/프로세스 정의** → 시스템 3문서 (경로: `memory/plans/<프로젝트명>/`)
- 구분: YAML frontmatter `scope: system | task`
- 상세: `memory/specs/3docs-schema.md`