Document clearing stored CLI findings

[nehal-a2z]

Document coderabbit review findings --clear --dir <path> alongside saved-output lookup. Require installed-command support and explicit user intent, and explain that clearing preserves other scopes and checkpoints without proving a fix or a clean review.

The note identifies CLI 0.7.6 as unsupported. Keep this draft for release coordination.

Validation: inspected the one-line documentation diff and ran git diff --check.

Summary by CodeRabbit

• Documentation
  • Documented the review findings --clear option, including its scope, behavior, preserved data, limitations, and CLI 0.7.6 incompatibility.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Enterprise

Run ID: 6f0371e1-ba9f-4292-880d-206872d42b61

📥 Commits

Reviewing files that changed from the base of the PR and between 929b0ec and abc61de.

📒 Files selected for processing (1)

• skills/code-review/references/cli-workflows.md

Included review availability: Your plan provides up to 100 included reviews per hour; 89 remain after this review.

📜 Recent review details

🔇 Additional comments (1)

skills/code-review/references/cli-workflows.md (1)

8-8: LGTM!

---

📝 Walkthrough

Walkthrough

The CLI workflow reference now documents scoped clearing of stored findings, including command support requirements, affected scopes, preserved data, limitations, and CLI 0.7.6 incompatibility.

Changes

CLI findings documentation

Layer / File(s)	Summary
Clear findings reference skills/code-review/references/cli-workflows.md	Documents coderabbit review findings --clear --dir <path> when the installed help supports --clear. It explains the selected scopes, no-confirmation behavior, preserved data, limitations, and CLI 0.7.6 incompatibility.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Other

Suggested reviewers: juanpflores

Merge Risk: ⚪ Minimal · up to abc61

This documentation-only change introduces no established merge-blocking risk.

---

Caution

Pre-merge checks failed

Please resolve all errors before merging. Addressing warnings is optional.

• Ignore (reviewers only)

❌ Failed checks (2 errors)

Check name	Status	Explanation	Resolution
Description check	❌ Error	The description explains the documented command, its scope, limitations, version incompatibility, and validation. It omits the required Affected surfaces, Public references, and Checklist sections, an…	Add the missing template sections. List the affected documentation and command surfaces, provide authoritative public references or state that none apply, complete the checklist, and report the exact result of git diff --check.
Agent Guidance Structure	❌ Error	The pull request changes a skill reference and adds the --clear option. The repository and current public CLI reference document review findings with --dir, but the public reference does not doc…	Update the canonical public CLI documentation and repository command guidance to document review findings --clear, its supported versions, and its scope semantics. Otherwise remove this guidance until the option is publicly documented and…

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly identifies the primary change: documenting how to clear stored CLI findings.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Description check

Explanation

The description explains the documented command, its scope, limitations, version incompatibility, and validation. It omits the required Affected surfaces, Public references, and Checklist sections, and does not state the result of the validation command.

Full details: Agent Guidance Structure

Explanation

The pull request changes a skill reference and adds the --clear option. The repository and current public CLI reference document review findings with --dir, but the public reference does not document --clear or the claimed CLI 0.7.6 incompatibility. The added option therefore does not agree with current public documentation, which is an explicit failure condition.

Resolution

Update the canonical public CLI documentation and repository command guidance to document review findings --clear, its supported versions, and its scope semantics. Otherwise remove this guidance until the option is publicly documented and supported.

• Fix all pre-merge checks with AI

✨ Finishing Touches

✨ Simplify code

• Create PR with simplified code
• Commit simplified code in branch nehal/cli-clear-stored-findings

---

_{A rabbit reads each line,
The patch grows clear beneath the moon,
Small changes hop in place,
Tests guard the garden path,
Reviews bloom before the dawn.}

_{Comment @coderabbitai help to get the list of available commands.}