Files
llm-wiki/.agents/plugins/wiki-superpowers/rules/reporting-standards

reporting-standards (plugin split)

Root SSOT: rules/reporting-standards.md (559줄)

본 폴더는 root rule 을 Antigravity 컨텍스트에서 lazy-load 하기 좋게 4개 sub-file 로 분할한 사본이다. 의미는 root 와 동일. 충돌 시 root 가 진실.

적용 대상

  • wiki research-lane 보고서, multi-file 문서 audit, raw → canonical 추출 권고, 링크 무결성 audit, 적대 리뷰 보고서, 멀티-파일 브레인스토밍, 1개 초과 wiki 파일을 다루는 모든 최종 응답.
  • 미적용: trivial 단일 파일 편집, 한 위치에서의 짧은 Q&A, 셸 명령 출력.

Sub-file index (필요 시점에 정독)

Sub-file 다루는 root section 필독 시점
output-split.md Output Split Policy 멀티-파일 / 멀티-findings 작성 직전
report-template.md §0 Source roots / §1 한눈 요약 / §2 Evidence Matrix / §3 Coverage / §3-1 Verdict 산식 / §5~§8 + Anti-Patterns 보고서 본문 작성 직전
findings-template.md §4 Per-File Findings (deep template + single/zero-finding gates) + §4-1 Adversarial Review per-file 분석 시
verification-rules.md §7.1 self-grep 카운트 규칙 (V/P/C/D/G/U) + §7.2 실행 명령 + 통계 fabrication 차단 verbatim quote 가 §4 에 있을 때

Language Contract (root 와 동일, 항상 적용)

  • 본문 산문은 사용자 언어. 한국어 사용자 → 한국어 본문. 영어 사용자 → 영어 본문.
  • 사용자 언어 무관 영어 유지: 섹션 필드명 (Verdict, Evidence Matrix, Status 등), Status 값 (READ_FULL, READ_PARTIAL, NOT_READ, BLOCKED), 명명된 실패 라벨 (FACT, INFERENCE, FILENAME_INFERENCE, MEMORY_HALLUCINATION, CONFIDENCE_WITHOUT_READ, BATCH_ASSUMPTION, UNVERIFIED), 파일 경로 / wikilink target / frontmatter 필드명.
  • bilingual mirroring 금지 — 한 본문, 한 언어.

Antigravity-specific 메모

항목 Antigravity 컨텍스트
Hook G1 (verification-rules.md §7.1 의 형식 검사) PreToolUse wiki_hard_gate.py 가 자동 enforce — docs/superpowers/specs/*.md write 시 §7.1 에 $ sed -n / $ grep -nF 명령이 0건이면 deny
Hook G2 (Anti-Patterns + Contract 7) 금지어 ("100%", "완벽" 등) 가 verbatim quote 밖에 있으면 deny
Hook G3 (§3-1 Verdict 산식) Verdict: COMPLETE 자가 라벨링 + M==N AND P==R 산식 부재 시 deny
Hook G4 (findings-template.md §4-1 존재 검사) ≥5 findings master report 인데 §4-1 Adversarial Review 부재 시 deny
Stop hook 한계 chat 본문 응답은 enforce 불가. specs/ 외 경로 (raw/, wiki/) 작성도 hook 미커버. agent self-check 단독.

자세한 hook 동작은 ~/.gemini/antigravity-cli/hooks/README.md 참조.

Format Discipline (always)

  • One file = one §4 subsection. 파일 묶지 않음.
  • No "Pillar / Group / Theme" grouping in §4. 그룹화는 §2 매트릭스 위쪽이나 §5 에서만.
  • Every claim cites <file:line>. 단정적 사실 + <file:line> 근거 없으면 그 문장 삭제 또는 INFERENCE 라벨.
  • §5 priority table only references analyzed files.
  • No mermaid/diagram filler.
  • No bilingual mirroring.

Pre-Send Format Check (essential 7)

송신 직전 다음 7개 확인. 하나라도 실패하면 draft 폐기. 전체 12 항목은 root rule §"Pre-Send Format Check" 참조.

  1. 본문 산문 언어가 사용자 언어와 일치?
  2. §1~§7 모두 존재 (해당 없으면 명시적 N/A)?
  3. §2 evidence matrix 행 수 = in-scope 파일 수? 불일치 시 §3 reconciliation 블록 있는가?
  4. §4 하위섹션 수 = §2 의 READ_FULL + READ_PARTIAL 행 수?
  5. §4 각 finding 이 verbatim quote + <file:line> 을 Original goal / Current state 에 포함?
  6. §5 priority 표의 모든 파일이 §4 에 하위섹션 보유?
  7. file:line 경로가 워크스페이스 상대 (또는 §0 alias) 형식? 절대 경로 /home/... 금지?