[Documentation] Use when generating, smart-merging or refactoring the root AI context (CLAUDE.md, AGENTS.md) and its Claude/Codex projections. Config file only: project-config.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
[Research] Use when a workflow step or the user asks for knowledge artifact review: completeness, citation accuracy, confidence and template compliance.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
Review modes: For review/audit work, standalone defaults to
--review-only(--report-onlyalias);--fix-loopenables review → validate → authorized fix → fresh re-review, default cap 3.--fix-loop --loop-owner=callerreturns a read-only pass to the caller that owns fixes/re-review. Create triage, review, validation and re-review todo tasks first; apply the carriedreview-policycontract for LOW deferral and user-approved bounded extensions. Non-review modes and terminal findings validation keep their own dispatch.
Goal: Ensure knowledge artifacts are evidence-backed, complete, protocol-compliant, and safe to use for decisions — reviewing for quality, completeness, citation accuracy, and template compliance.
Summary:
minRounds is met; otherwise validate and fix only current-round blocking findings, then full re-review until the severity bar is clear (Round 2 LOW-only findings are deferred and end the loop).Workflow:
/why-review --validate-findings <report-path>, then emit the summary with pass/warn/fail per checkKey Rules:
Apply skeptical, sequential thinking; trace every claim and state confidence (>80% to act).
The full gate is
SYNC:core-engineering-principles(protocol guide below; a hook delivers its text); its closing digest ends this file.
Default stance: SKEPTIC challenging research quality, NOT confirming research completeness.
Source confirmation bias trap: AI gravitates toward sources confirming its working hypothesis. Knowledge artifact built iteratively — by completion, framing is locked in. This section forces challenge of both sources AND framing.
1. Source Bias Detection Top 3 claims: "What sources CONTRADICT this claim?" No contradicting source cited → either reviewer didn't look, or evidence truly one-sided. Ask: "What would skeptic of this conclusion cite?" No counterevidence addressed → confidence score inflated.
2. Confidence Calibration Challenge Each confidence score ≥ 80%: "What would need to be true for this confidence to be wrong?" High confidence warranted ONLY when: (a) multiple independent sources agree, (b) contradicting evidence addressed, (c) methodology sound. Challenge any score resting on single source or undisclosed assumptions.
3. Alternative Conclusion Check Given same evidence, what DIFFERENT conclusion could reasonable expert reach? Artifact not addressing 1+ credible alternative interpretation → analysis incomplete. State strongest alternative conclusion.
4. Cherry-Picking Detection Count sources supporting main conclusion vs. sources challenging it. Ratio > 3:1 favoring supporting sources without explicit explanation of why contradicting sources discounted → flag cherry-picking.
5. Pre-Mortem Assume artifact's recommendation implemented and fails. Write most plausible failure scenario given research limitations. Artifact not acknowledging this failure mode → missing a risk section.
6. Contrarian Pass Before writing any verdict, generate 2+ sentences arguing OPPOSITE conclusion about artifact's quality. Then decide which argument is stronger.
Citation presence, plausible scores, broad coverage, and actionable wording are insufficient without source support, confidence stress tests, missing-perspective checks, and an evidence chain. Never approve without challenging evidence quality; the closing Anti-Rationalization table gives the corresponding checks.
Any item unmet → adversarial review incomplete. Go back. — why: skipping the gate ships confirmation-biased verdicts as fact.
At core depth (Artifact Profile and Depth) the gate is the compressed three-item form stated there; full depth runs all six items.
Set both before the checklist and record them in the review output.
Profile — the artifact type selects the template and the rows. Every type runs all 7 checklists against its own template, with the exceptions below. A row that checks a section its template does not define (Recommendations, a Gaps section) is recorded N/A with that reason, never failed; its duty still applies, so open gaps, limitations and low-confidence claims stay flagged beside the claims they affect.
| Artifact type | Written to | Template | Row exceptions |
|---|---|---|---|
| Research report | docs/knowledge/research/ | .claude/templates/research-report-template.md | None |
| Market analysis | docs/knowledge/strategy/market-analysis/ | .claude/templates/market-analysis-template.md | None |
| Business evaluation | docs/knowledge/strategy/business/ | .claude/templates/business-evaluation-template.md | None |
| Marketing strategy | docs/knowledge/strategy/marketing/ | .claude/templates/marketing-strategy-template.md | None |
| Course outline | docs/knowledge/courses/ | .claude/templates/course-outline-template.md | No per-finding confidence row; its Sources table is Resources & References; add the pedagogy check |
Pedagogy check (course outlines): objectives are measurable (an observable verb at a stated Bloom level); objectives and assessments align, so every objective is tested by at least one knowledge-check or final-assessment item and every assessment item traces to an objective; prerequisites are stated for the course, and each module builds on the earlier ones.
An artifact type outside the table uses the template its producer skill names; with none, review it against the research-report rows and record that assumption.
Depth — the scope triage selects how much runs. Read the triage the workflow recorded (workflow-research records Narrow, Standard or Broad in its workflow report); standalone, classify with the Question-Scope Triage table in .claude/skills/workflow-research/SKILL.md.
| Depth | When | Runs |
|---|---|---|
| Core | Narrow scope, and no decision rides on the artifact | Checklists 1 Template, 2 Citation, 3 Confidence and 6 Cross-Validation (with the profile's exceptions), plus the compressed Anti-Bias Gate: 1+ contradicting source for the main claim (or its absence flagged), a stress test of the highest score ≥80%, and 2+ sentences arguing the opposite verdict |
| Full | Standard or Broad scope, a decision-critical artifact (business evaluation, marketing strategy, any go/no-go input), or triage unknown | Every applicable row and the full Anti-Bias Gate |
Check both presence and substantive quality for every row; headings, placeholders, or generic filler do not pass.
| Check | Verify presence and depth |
|---|---|
| All enforced sections present | Every template section has substantive content; missing or partially filled sections fail. |
| No empty placeholders | Reject “TBD”, “to be filled”, and generic filler such as “risks will be identified later”. |
| Section order matches template | Preserve prescribed order and verify cross-references still make sense. |
| Check | Verify presence and depth |
|---|---|
Every factual claim has inline [N] | Read the source: it must support the specific claim or paraphrase. |
| Every Sources row is cited | Cite at the most specific supported claim; reject unused credibility-padding sources and vague section-level citations. |
| No orphan citations | Every [N] resolves to a Sources row; numbering stays consistent, without gaps or duplicates. |
| Sources table has: Title, URL, Author, Date, Tier | Verify all five fields, accurate Tier and topic-appropriate Date. A blog labeled Tier 1 inflates authority. |
| Check | Verify presence and depth |
|---|---|
| Per-finding scores | Each finding has its own explicit percentage; section/artifact scores cannot substitute. |
| Overall confidence | Require a reasoned aggregate, not the highest finding score; 85%, 60%, and 40% do not aggregate to 85%. |
| Scores match evidence | Justify source count, independence and quality; name what would lower each score. A single source ≠ 80%; scores >80% require 2+ independent sources and addressed counterevidence. |
| Findings <60% flagged prominently | Visually distinguish and position low-confidence findings so skimming readers cannot mistake them for facts. |
| Check | Verify presence and depth |
|---|---|
| Appropriate Tier distribution | Record distribution; Tier 4 must be a minority, never the entire set. Assess authority per claim: unrelated Tier 1 sources do not rescue a core Tier 4 claim. |
| At least 50% Tier 1-2 for key claims | Verify the overall threshold and authoritative support for key/high-stakes claims; prestige outside the claim's domain is insufficient. |
| Topic-appropriate recency | Date and assess each source against the topic's rate of change; flag stale sources. Cloud pricing ages faster than database theory. |
| Check | Verify presence and depth |
|---|---|
| Honest Gaps section | State specific unanswered questions, ranked by impact on conclusions, to guide follow-up; “some uncertainty exists” is insufficient. |
| Explicit limitations | Distinguish methodological/coverage limitations from gaps. State a limitation near any finding it invalidates, before using it to discount the finding; a late footnote is insufficient. |
| Further research | Include 1+ suggestions tied to gaps, with specific query + source type; prioritize gaps affecting decisions. |
| Check | Verify presence and depth |
|---|---|
| Key claims have 2+ sources | Verify genuine independence; sources citing each other or the same original study are amplification, not validation. |
| Conflicts documented and resolved | Explain which source was weighted more and why; merely noting disagreement is insufficient. |
| Single-source claims unverified | Explicitly label them “unverified” or equivalent, with confidence <60%; an unverified claim at 75% contradicts itself. |
| Check | Verify presence and depth |
|---|---|
| Concrete recommendations | State who does what, assignable to a role without clarification. “Improve monitoring” is vague; “add P99 latency alert at 500ms” is actionable. |
| Evidence-based next steps | Trace each action to a finding and confidence score; label actions based on low-confidence evidence (e.g. 40%) speculative, not directives. |
| Accurate executive summary | Capture key findings with confidence caveats and limitations; never turn a 60%-confidence finding into fact for readability. |
## Knowledge Review Result
**Status:** PASS | WARN | FAIL
**Artifact:** {path}
**Profile:** {artifact type} · **Depth:** {core | full} — {triage evidence}
### Checks (N/7 passed; N/A rows named with reason)
- [x] Template compliance
- [x] Citation audit
- [ ] Confidence accuracy — {issue}
- [ ] Source quality — {issue}
...
### Issues
- {specific issues found}
### Verdict
{APPROVED | REVISE | BLOCKED}
Convergence follows the single contract in SYNC:review-policy below: a clean Round 1 ENDS the review once the persisted minRounds is met (default 1); an explicitly required independent pass is still mandatory. Re-review is triggered by a validated-finding fix cycle (review → validate findings → fix → full re-review) or an explicitly declared independent-pass minimum, not by a round number alone.
When Round 1 surfaces findings, run this focused re-review as part of that full re-review (do NOT rely on Round 1 memory):
[IMPORTANT] Use
TaskCreateto break ALL work into small tasks BEFORE starting.
Prerequisites: MUST ATTENTION READ before executing:
<!-- PROTOCOL-GUIDES:START -->Review scope: Review the knowledge artifact’s completeness, citations, confidence, and stated claims. Research-only artifacts have no application-inheritance or linter prerequisite. When an artifact makes code-linked claims, inspect only the referenced code and applicable project rules to verify those claims; route a requested code-design review to its code-review owner. Do not prescribe empty base classes or unrelated tooling.
Protocol guides — Apply each protocol only when its read-when condition holds. If a protocol's text is not in your context, read its file below before you act on it.
core-engineering-principles — Core quality gate: easy to change, easy to scale, easy to maintain, judged by future change cost; planning, implementing or reviewing any change → .claude/skills/shared/protocols/core-engineering-principles.mdgoal-contract-satisfaction-loop — Save the goal in a file and loop until every saved criterion passes; executing work against a user goal → .claude/skills/shared/protocols/goal-contract-satisfaction-loop.mdreview-decision-autonomy — Choose supported review decisions and ask before extending the round budget; running any review or audit skill or mode → .claude/skills/shared/protocols/review-decision-autonomy.mdreview-policy — Review-only or a three-round fix loop with explicit extension and fresh post-fix evidence; deciding round eligibility, blocking findings or review state → .claude/skills/shared/protocols/review-policy.mdreview-principle-awareness — Classify the change context first, then apply the current principles that fit it; starting any review → .claude/skills/shared/protocols/review-principle-awareness.mdreview-protocol-injection — Verbatim template and protocol blocks for every fresh sub-agent review prompt; spawning a fresh sub-agent to review → .claude/skills/shared/protocols/review-protocol-injection.mdseverity-rubric — One consequence-based Critical, High, Medium, Low scale for every finding and gate; classifying a finding or deciding whether a review round passes → .claude/skills/shared/protocols/severity-rubric.mdtask-tracking-external-report — Task breakdown before the work and report files written incrementally; starting any multi-step skill, plan or review → .claude/skills/shared/protocols/task-tracking-external-report.mdtrade-off-interrogation-gate — Three trade-off questions before any verdict, score or recommendation; rendering a verdict or recommending an option → .claude/skills/shared/protocols/trade-off-interrogation-gate.mdweb-research — Structured web search for evidence gathering; gathering external evidence from the web → .claude/skills/shared/protocols/web-research.mdIMPORTANT MUST ATTENTION cite 2+ independent sources per claim. NEVER fabricate — "No evidence found" is valid output.
<!-- /SYNC:web-research:reminder --> <!-- SYNC:task-tracking-external-report:reminder -->tmp/reports/ incrementally and synthesize from disk.NOT VERIFIABLE only when the concern would be MEDIUM or higher (an observation otherwise) — never a speculative LOW.goal.md → <plans root>/goals/{YYMMDD-HHmm}-{slug}/goal.md, plans root default plans and overridable via a docsRoots.plans.path entry in docs/project-config.json → create from current request) and read saved success criteria before editing.Review/audit invocations: follow SYNC:review-decision-autonomy for every decision prompt; choose supported recommendations without asking, preserve round-extension approval and actual authority.
ask user question tool BEFORE the verdict.ask user question tool reaches only the main interactive agent, so a sub-agent or a terminal/verdict-only mode cannot ask. There the duty is REDIRECTED, not waived: still name the trade-off, still decide materiality, record confirmed? = NO — cannot ask from this context, and state the unconfirmed MATERIAL trade-off in your RETURNED verdict so the CALLER escalates it (a note only in an on-disk report is not a handoff); never emit an unqualified PASS. If you CAN ask, you MUST ask.IMPORTANT MUST ATTENTION Every review first checks the change context and routes only applicable principles to their detailed protocols: scale-ready foundation, test intent in the project's native format (GWT is one option), AI-agent-as-user access, and UI/component design when relevant. Record evidence-backed apply/adapt/defer/N/A/block/unverified status with owner and next step; do not invent unrelated findings or expand scope.
<!-- /SYNC:review-principle-awareness:reminder --> <!-- SYNC:review-decision-autonomy:reminder -->MUST ATTENTION Decide supported review choices and recommendations, record the rationale, and finish without routine user questions. Keep round-limit extension, indispensable facts and actual action authority; preserve source coverage, validation, tests, read-only boundaries and budgets. Review decisions do not accept open risks or make a failed gate pass.
<!-- /SYNC:review-decision-autonomy:reminder -->IMPORTANT MUST ATTENTION Goal: Ensure knowledge artifacts are evidence-backed, complete, protocol-compliant, and safe to use for decisions — reviewing for quality, completeness, citation accuracy, and template compliance.
Protocols in force (concise digest of the SYNC/shared blocks this skill carries):
tmp/reports/ incrementally.SYNC:severity-rubric; round 1 blocks on every open validated finding (LOW deferral), round 2 blocks only CRITICAL/HIGH/MEDIUM, and LOW is recorded/deferred. Failed binary gates always block.IMPORTANT MUST ATTENTION default SKEPTIC, not VALIDATOR — run the full Anti-Bias Gate before ANY verdict (core depth: the compressed three-item gate): 1+ contradicting source per major claim, stress-test every score ≥80%, state the strongest alternative conclusion, check supporting-vs-contradicting source ratio, run a pre-mortem, argue the opposite verdict in 2+ sentences
IMPORTANT MUST ATTENTION calibrate confidence to evidence — a single source ≠ 80%; scores >80% need 2+ independent sources with contradicting evidence addressed; single-source claims marked unverified MUST be <60%; findings <60% flagged prominently
IMPORTANT MUST ATTENTION main steps in order — read artifact + set profile and depth → 7-checklist audit (presence AND quality depth) → adversarial Anti-Bias Gate → emit PASS/WARN/FAIL per-check + verdict (APPROVED/REVISE/BLOCKED) → conditional Round 2 re-review
IMPORTANT MUST ATTENTION verify presence AND quality depth on every row the profile and depth select from the 7 checklists (template compliance, citation audit, confidence accuracy, source quality, knowledge gaps, cross-validation, actionability); course outlines add the pedagogy check
IMPORTANT MUST ATTENTION validate findings with /why-review --validate-findings whenever the report has findings, before any repair
IMPORTANT MUST ATTENTION Review-only/caller-owned passes report without artifact edits; standalone fix-loop repairs validated findings between passes, then freshly audits citations and the full artifact.
TaskCreate BEFORE starting; add a final review todo to verify work quality[N] / source-table row (use file:line only for the rare code-linked claim); confidence >80% to act, <60% DO NOT recommendlessons.md) before the target review; classify findings Critical/High/Medium/Low by consequence (severity rubric) — round 1 blocks on every open validated finding (LOW deferral); round 2 blocks only CRITICAL/HIGH/MEDIUM, while LOW is recorded/deferred and failed binary gates always block[TASK-PLANNING] Before acting, analyze task scope and systematically break it into small todo tasks and sub-tasks using TaskCreate.
Anti-Rationalization:
| Evasion | Rebuttal |
|---|---|
| "Sources are cited" | Presence ≠ quality — verify each source actually supports the SPECIFIC claim, not just sits in the table. |
| "Confidence scores look reasonable" | Name what would LOWER each score ≥80%. No answer = inflated. A single source is not 80%. |
| "Comprehensive coverage" | State the strongest alternative conclusion and the perspective MISSING — absence of counterevidence ≠ consensus. |
| "Recommendations are actionable" | On what evidence, at what confidence? A directive from a 40%-confidence finding must be labeled speculative. |
| "Clean enough, skip the Anti-Bias Gate" | The gate is MANDATORY before any verdict — skipping it ships confirmation-biased approval as fact. |
| "I'll fix while judging citations" | Keep each review pass read-only; only the standalone fix-loop owner repairs after validation, then runs a fresh independent audit. |
IMPORTANT MUST ATTENTION Goal (recency anchor): ship only evidence-backed, complete, protocol-compliant knowledge artifacts — Anti-Bias Gate, confidence calibrated to source count/quality and validated severity-tiered findings. Review-only reports; standalone fix-loop repairs between read-only passes and freshly reviews until the shared round bar is clear, default cap three.
<!-- SYNC:core-engineering-principles:reminder -->MUST ATTENTION Core Engineering Principles — every plan, implementation and review must be Easy to change (reuse first, one owner per rule, interfaces/adapters at volatile boundaries, no speculative abstraction) · Easy to scale (extend by addition, bounded growth, explicit boundaries, sized to the project's real profile) · Easy to maintain (intent-named tests that fail when the rule breaks across happy/error/edge paths; harness green locally and in CI). Before done: next change → how many edit sites? 10× → what breaks? which test goes red?
<!-- /SYNC:core-engineering-principles:reminder --> <!-- SYNC:review-policy:reminder -->MUST ATTENTION Triage all targets, plan and create review/validation/fix/fresh re-review tasks first. Review-only reports without edits; fix-loop freshly reviews every repair under one fixing owner. Default cap three rounds: disclose deferred LOWs, ask and wait before a bounded extension for MEDIUM+ or failed required checks. Preserve scope, coverage and actual operation authority.
<!-- /SYNC:review-policy:reminder -->아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
[Documentation] Use when generating, smart-merging or refactoring the root AI context (CLAUDE.md, AGENTS.md) and its Claude/Codex projections. Config file only: project-config.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
[Code Quality] Use when a workflow step or the user asks for AI code or plan review: LLM calls, prompts, agents, RAG, evals and guardrails. --mode={code|plan}; --report-only is read-only.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
[Architecture] Use when a workflow step or the user asks for architecture design, compliance review, scalability grading or whole-project audit via --mode={design|review|scalability|full}.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
[Content] Use when a workflow step or the user asks for product/feature ideation with ranked opportunities and validation tests. --mode={roadmap|scope}.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
[Content] Use when a workflow step or the user asks for business viability: Business Model Canvas, financials, risks and go-to-market recommendation.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
[Code Quality] Use when a workflow step or the user asks for a focused code-change review: staged, unstaged, branch diff or simple pull request. --fix-loop fixes and re-reviews. Complex pull request: workflow-review-changes; rationale: why-review.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.