chore: docs sweep feedback fixes (chore-docs-sweep-feedback)

[moui72]

Summary

• Reconciliation spot-check note in ardd-defects reference (T001)
• Expanded pre-flight bullet (four resolved-path kinds + artifacts-dir ask) in ardd-implement reference (T002)
• Distinguish never-guesses vs never-overclaims in ardd-init reference (T003)
• Document plan_preview_editor alongside plan_preview in ardd-plan reference (T004)
• Note Claude harness safe pre-harness fallback in ardd-update reference (T005)
• Verified ./scripts/lint-docs.sh passes (T006)

Executes tasks-chore-docs-sweep-feedback-745e.md against plan-chore-docs-sweep-feedback-2026-07-24-8c58.md (features: []).

Summary by CodeRabbit

• Documentation

  • Clarified defect reconciliation behavior, preserving claims that remain valid.
  • Expanded implementation pre-flight and commit guidance, including artifact checks.
  • Added conservative wording for coverage claims in initialization guidance.
  • Documented the new plan_preview_editor configuration and its interaction with previews.
  • Reflowed update guidance for older Claude harness sources.

• Project Planning

  • Added a documentation-sweep plan, completed task checklist, and related feedback records.
  • Updated project status and ArDD version metadata.

[coderabbitai]

Warning

Review limit reached

@moui72, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 8 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 5af892cc-4783-4015-8fb8-064520f47206

📥 Commits

Reviewing files that changed from the base of the PR and between 1e3d6e4 and bb6f885.

📒 Files selected for processing (1)

• .project/STATUS.md

Walkthrough

The change records a documentation sweep, adds its feedback, plan, and task artifacts, updates five reference pages, and refreshes project status and ArDD source metadata.

Changes

Documentation sweep

Layer / File(s)	Summary
Feedback, plan, and task tracking .project/feedback/*, .project/plans/*, .project/tasks/*	Adds five planned feedback entries, an approved sweep plan, and completed tasks covering the documentation corrections and lint validation.
Reference documentation alignment docs/reference/skills/ardd-*.md	Documents defect reconciliation, expanded implementation pre-flight handling, conservative init claims, plan preview editor behavior, and reformatted harness wording.
Project state and source metadata .project/STATUS.md, .project/ardd-version.md	Refreshes session status, workflow metrics, and the active ArDD source timestamp and commit.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• moui72/artifact-driven-dev#15: Related implementation documentation for delegation pre-flight and auto-commit behavior.
• moui72/artifact-driven-dev#16: Related collaborative worktree-alignment feedback recorded in project status.
• moui72/artifact-driven-dev#9: Related ArDD version and collaborative workflow metadata updates.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the PR’s docs-sweep feedback fixes and matches the main change set.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch worktree-agent-a9ab51aacfd6ed53a

---

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

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.project/STATUS.md:
- Line 3: Refresh the STATUS.md snapshot using the completed implementation
state: update the current _Updated entry to reflect that the plan/tasks and five
reference-page changes are completed and committed, removing the outdated
auto-run /ardd-implement wording. Reconcile the backlog counts with the existing
“Recommended Next Step” section, ensuring no stale backlogged-feature
recommendations remain when the backlog is empty while preserving required
historical entries.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 633461cf-ca66-4b5d-93da-72f6f4300aa4

📥 Commits

Reviewing files that changed from the base of the PR and between d67fdc1 and 1e3d6e4.

📒 Files selected for processing (14)

• .project/STATUS.md
• .project/ardd-version.md
• .project/feedback/feedback-ardd-defects-reconciliation-docs-4cbd.md
• .project/feedback/feedback-ardd-implement-pre-flight-docs-e370.md
• .project/feedback/feedback-ardd-init-overclaim-docs-fb81.md
• .project/feedback/feedback-ardd-plan-preview-editor-docs-2301.md
• .project/feedback/feedback-ardd-update-harness-docs-15a4.md
• .project/plans/plan-chore-docs-sweep-feedback-2026-07-24-8c58.md
• .project/tasks/tasks-chore-docs-sweep-feedback-745e.md
• docs/reference/skills/ardd-defects.md
• docs/reference/skills/ardd-implement.md
• docs/reference/skills/ardd-init.md
• docs/reference/skills/ardd-plan.md
• docs/reference/skills/ardd-update.md