1. 본 섹션의 목적

AXE Labs 가 운영 중 발견한 함정 또는 feature request 중:

• AXE 자체 fix 가 부분 fix 인 경우 (예: client-side workaround)
• upstream 측 영구 fix 가 본질 (예: 라이브러리 자체 패치 필요)
• 다른 사용자도 영향 받을 함정 (i18n, accessibility, edge case)

해당하는 사안의 self-contained 보고 draft 를 본 섹션에 보관. 운영자가 검토 후 다음 채널 중 적절한 곳으로 제출:

• Vendor email support
• GitHub issue / discussion
• GitHub pull request
• 표준 단체 (RFC 등) — 해당 시

2. 현재 보유 reports

3. 신규 보고 작성 가이드

새 함정·feature request 의 upstream 보고 draft 작성 시:

파일 명명

<descriptive-slug>-YYYY-MM.mdx (예: claudeapp-fd-leak-2026-05.mdx)

• slug = upstream system + 함정 type
• YYYY-MM = 발견 또는 작성 시점

권장 섹션 구조 (10 섹션, self-contained)

1. Summary — 1-2 문장 요약
2. Environment — OS, app version, hardware, uptime 등 repro 환경
3. Symptom — failure mode + reproduction steps + diagnostic commands
4. Workarounds — 현재 사용 가능한 우회 + AXE 측 자체 fix (있다면)
5. Suspected root cause — 분석 + 증거
6. Impact — 영향 범위 (user 수, scenario 등)
7. Requested fix — upstream 측에 요청하는 변경 (가능하면 code 또는 spec 단위)
8. Attachments — diagnostic logs, screenshots, code refs (path)
9. Channels — 어디 제출할지 (email, GitHub repo URL, etc.)
10. Status — draft → submitted → response → resolved

MDX 주의사항

• code 는 fenced block 안
• placeholder <tenant> <name> 등은 backtick 안 또는 <...> escape
• frontmatter title 은 사람 읽기 쉬운 한 문장

_meta.js 등재

파일 생성 후 /Users/axe/axelabs-docs/content/ops/reports/_meta.js 에 entry 추가:

"new-report-slug-YYYY-MM": "사람 읽기 쉬운 제목"

4. backlog 연계

본 섹션의 모든 report 는 backlog 의 대응 항목과 cross-link 권장:

• backlog entry → report link (entry 본문에 → /ops/reports/<slug> 명시)
• report frontmatter → backlog link (optional, history 추적용)

수락/회신 시 status 업데이트:

• 본 페이지 표의 “상태” 열 갱신
• backlog 의 ✅ Done 으로 이동 시점 = upstream 측 수락 또는 운영자가 close 결정