docs(ci-standards): feature-ideation backlog enhancement (backfill) + dry-run

[don-petry]

Documents the new enhance_backlog sweep + dry_run preview + marker continuity in ci-standards §9 — the docs portion of the backfill epic petry-projects/.github-private#936. Refs #934, #872.

Summary by CodeRabbit

• Documentation
  • Expanded the feature ideation workflow guide with instructions for backfilling existing ideas.
  • Added a preview mode that generates intended comment output without posting changes.
  • Clarified how enhanced items are detected, including support for legacy markers.
  • Noted that single-item handling takes priority when both single-item and backlog modes are configured.

[coderabbitai]

Warning

Review limit reached

@don-petry, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 56 minutes and 37 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

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 credits.

🚦 How do rate 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 see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 07c0057e-a3ba-48d9-aa7a-fa8a0f82d5eb

📥 Commits

Reviewing files that changed from the base of the PR and between d0ba06a and 1950cbd.

📒 Files selected for processing (1)

• standards/ci-standards.md

📝 Walkthrough

Walkthrough

The documentation adds Feature Ideation backlog backfill support for reusable dispatches, documents a dry-run mode that writes intended comments to JSONL, and defines enhanced-discussion idempotency and target-discussion precedence rules.

Changes

Feature Ideation workflow docs

Layer / File(s)	Summary
Workflow docs update standards/ci-standards.md	Adds backfill dispatch instructions, dry-run preview output, dual enhanced-marker idempotency, and target_discussion precedence rules for Feature Ideation.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related issues

• petry-projects/.github-private issue 937 — Mentions the same Feature Ideation backfill, dry-run, and idempotency contract documented in this PR.
• petry-projects/.github-private issue 936 — Also matches the Feature Ideation backfill/dry-run/idempotency workflow documentation changes.

Possibly related PRs

• petry-projects/.github#539 — Directly matches the documented feature-ideation backfill, dry-run, and marker continuity behavior.
• petry-projects/.github#448 — Updates the same target_discussion and enhancement-marker semantics in standards/ci-standards.md.
• petry-projects/.github#53 — Also extends the Feature Ideation section in standards/ci-standards.md.

🚥 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 clearly matches the doc update for feature-ideation backlog backfill and dry-run behavior.
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 docs/feature-ideation-backfill

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[gemini-code-assist]

Code Review

This pull request updates the standards/ci-standards.md file to document the backlog enhancement (backfill) and dry-run features of the feature ideation workflow. The review feedback suggests capitalizing "ideas" to "Ideas" in two instances to maintain consistency with the rest of the document.

[don-petry]

Dev-Lead — review-changes (applied)

Changes committed and pushed.

[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 `@standards/ci-standards.md`:
- Around line 912-930: The markdown in the backlog enhancement section violates
MD031 because the fenced bash block in this docs snippet is missing required
blank lines before and after it. Update the text around the code fence in the
feature-ideation/backfill guidance so there is an empty line before the opening
```bash and an empty line after the closing ``` while preserving the surrounding
copy about enhance_backlog and dry_run.

🪄 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: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 7ef84d3c-521c-4da1-944a-bdbffbde4956

📥 Commits

Reviewing files that changed from the base of the PR and between 78ede00 and d0ba06a.

📒 Files selected for processing (1)

• standards/ci-standards.md

[don-petry]

Dev-Lead — review-changes (applied)

Changes committed and pushed.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[don-petry]

Dev-Lead — fix-bot-comment (no-changes)

Agent reasoning

**Status:**
- ✅ **SonarCloud Quality Gate:** Passed — 0 new issues, 0 security hotspots
- ✅ **CodeRabbit MD031 violation:** Already fixed in commit 9b71022 (chore: apply manual instructions)
  - The blank lines before and after the fenced bash code block in `standards/ci-standards.md` (lines 912-930) are present and correct
  - Thread is marked resolved
- ✅ **All CI checks:** Passing (Lint, ShellCheck, CodeQL, SonarCloud, npm audit, etc.)
- ✅ **No Tier 1 blockers:** All checks passed, no CHANGES_REQUESTED reviews
**Files status:**
- `standards/ci-standards.md` — already compliant, no changes needed
**Conclusion:** The PR is ready. All bot findings have been previously addressed. No further action required.

[don-petry]

@donpetry-bot review

[donpetry-bot]

@don-petry I'm on it — starting a fresh review now. Results will appear in a few minutes.

[donpetry-bot]

Automated review — APPROVED ✓

Risk: LOW
Reviewed commit: 1950cbdf471df34ccd0ff32a17f3f59f85e6175b
Review mode: triage-approved (single reviewer)

Summary

Docs-only change: adds 21 lines to standards/ci-standards.md §9 documenting the Feature Ideation backlog backfill (enhance_backlog), dry_run preview, dual enhanced-marker idempotency, and target_discussion precedence. No code, workflow, or config changes.

Linked issue analysis

No closing issue references (PR uses Refs to .github-private#936/#934/#872, the backfill docs epic). Nothing to substantively close; the diff matches the stated docs scope.

Findings

No blocking findings. Prior CodeRabbit MD031 (missing blank lines around the bash fence) was resolved in commit 9b71022 — the fence at lines 912-930 now has correct surrounding blank lines, and CodeRabbit's final review APPROVED the head SHA. gemini-code-assist left a non-blocking style suggestion (capitalize 'ideas' -> 'Ideas'); optional, not required for approval. Secret-scanning MCP tool not available in this run; relied on the green gitleaks CI check.

CI status

Green. Lint, ShellCheck, CodeQL, SonarCloud (Quality Gate passed), gitleaks, npm audit, AgentShield, Agent Security Scan all SUCCESS. The two CANCELLED dev-lead checks are superseded agent-workflow runs (a later dev-lead dispatch ran SUCCESS), not failures. mergeStateStatus is BLOCKED only on the required org-leads human review.

---

Reviewed automatically by the PR-review agent (single-reviewer mode: fable 5). Reply if you need a human review.