# Telegram 보고 포맷 규칙 (제이회장님 확정)

## 핵심 원칙
**아누가 제이회장님께 보고할 때, 보고서 원문(md)을 그대로 보여주지 않는다.**
반드시 Telegram 친화적 포맷으로 가공하여 보고한다.

## 금지 사항
1. **마크다운 헤더(#, ##, ###) 사용 금지** — Telegram에서 `##` 그대로 노출
2. **코드블록(```) 사용 금지** — 보고에 코드 넣지 말 것
3. **테이블(|---|) 사용 금지** — Telegram에서 깨짐
4. **SCQA 원문 형식 사용 금지** — S/C/Q/A 라벨 노출 금지
5. **보고서 파일 내용 그대로 복붙 금지** — 반드시 가공

## 허용 표현
- **Bold** (**텍스트**) — 강조
- 구분선 (---) — 섹션 구분
- 리스트 (- 또는 1. 2. 3.) — 항목 나열
- 일반 텍스트 — 설명

## 완료 보고 구조 (아누 → 제이회장님)

```
**task-XXX.X 완료 보고 (N팀 팀장이름)**
**작업 제목** (소요시간)

- 핵심 결과 1
- 핵심 결과 2 (정량 수치 포함)
- 핵심 결과 3

**발견/해결 이슈 N건**
- 이슈1: 해결 방법
- 이슈2: 해결 방법
```

## 아누 보고 프로세스 (필수)

1. 보고서 파일(memory/reports/task-xxx.md) 읽기
2. Task tool(haiku)로 보고서를 Telegram 포맷으로 변환 요청
3. 변환된 결과를 제이회장님께 전달

### haiku 변환 프롬프트 템플릿

```
아래 보고서를 Telegram 보고용으로 가공해줘.

규칙:
- 마크다운 헤더(##) 제거 → Bold(**텍스트**)로 대체
- 코드블록 제거 → 핵심만 텍스트로
- SCQA 라벨 제거 → 결과 중심
- 테이블 제거 → 리스트로 변환
- 3~10줄 이내 핵심만
- 정량 수치(테스트 통과율, 파일 수, 소요시간) 반드시 포함

출력 포맷:
**task-ID 완료 보고 (N팀 팀장이름)**
**작업 제목** (소요시간)

- 핵심 결과 1
- 핵심 결과 2
...

**발견/해결 이슈 N건**
- 이슈 요약

보고서:
{report_content}
```

## 예시 (Before → After)

### Before (금지)
```
**task-938.1 완료 보고** (dev4-team)
**완료 보고서: 작업별 토큰 사용량 추적 엔진 + 워크플로우 통합** (18분 13초)

**핵심 결과**
6개 Phase 전체 구현 완료. 토큰 파싱 엔진(token-tracker.py)으로 1,956개 JSONL 세션을 스캔...

## 생성/수정 파일 목록
...

**발견/해결 이슈 3건**
1. **봇 워크스페이스 세션에 task_id 없음**
```

### After (올바른 포맷)
```
**task-938.1 완료 보고 (4팀 비슈누)**
**작업별 토큰 사용량 추적 엔진 + 워크플로우 통합** (18분 13초)

- token-tracker.py 구현 (193줄), 1,956개 세션 스캔 → 763개 태스크 토큰 원장 생성
- task-timers.json 623건에 토큰 데이터 자동 연동
- 대시보드 API 2개 추가 (/api/token-usage, /api/token-anomaly)
- 총 토큰 21.9억, 추정 비용 $3,006, 이상치 70건 감지
- pytest 24/24, pyright 0 에러

**발견/해결 이슈 3건**
- 봇 워크스페이스에 task_id 없음 → 디스패치 세션만 매칭
- content가 list 형태 → _text() 헬퍼로 양쪽 처리
- task-4.4 627M 토큰 이상치 → anomaly 명령으로 정상 감지
```