59 lines
4.1 KiB
Markdown
59 lines
4.1 KiB
Markdown
# reporting-standards (plugin split)
|
|
|
|
Root SSOT: [`rules/reporting-standards.md`](../../../../../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.md) | Output Split Policy | 멀티-파일 / 멀티-findings 작성 직전 |
|
|
| [`report-template.md`](report-template.md) | §0 Source roots / §1 한눈 요약 / §2 Evidence Matrix / §3 Coverage / §3-1 Verdict 산식 / §5~§8 + Anti-Patterns | 보고서 본문 작성 직전 |
|
|
| [`findings-template.md`](findings-template.md) | §4 Per-File Findings (deep template + single/zero-finding gates) + §4-1 Adversarial Review | per-file 분석 시 |
|
|
| [`verification-rules.md`](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`](file:///home/donghyeon/.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/...` 금지?
|