Skip to content

chore(docs): file curated backlog issues (#39–#58) + rot-free work map (#37)#59

Merged
mobileskyfi merged 1 commit into
mainfrom
chore/file-curated-issues-37
Jul 3, 2026
Merged

chore(docs): file curated backlog issues (#39–#58) + rot-free work map (#37)#59
mobileskyfi merged 1 commit into
mainfrom
chore/file-curated-issues-37

Conversation

@mobileskyfi

@mobileskyfi mobileskyfi commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

What

Second half of #37. With the Issue→PR scheme merged (#38), triage BACKLOG.md's
"not yet filed" checklist into a curated set of GitHub Issues — the "one list"
to comment on and use as a starting point for discussion — and slim BACKLOG.md to a
rot-free map.

Curated, not 1-to-1 (per the steer: umbrella where triage is still owed).

Issues filed (#39#58)

Concept anchor#39 optional centrs exec passthrough (needs-decision). Tracks
the concept (opt-in route through centrs' validate→explain→run for richer
warnings/tips; name TBD), explicitly not designed here. Folds the centrs-owned
cluster
exec() soft-error detection, protocol-adapter reuse, bidirectional
MAC-Telnet — as checklist items there, not as separate quickchr issues: they're more
involved than QEMU-focused quickchr and drove centrs' design ("in a sense done, in
centrs").

Triage umbrellas (research; done-when = break out sub-issues or land a REPORT.md,
then close) — #40 Windows (the "ground yourself before claiming X fails on Windows"
anchor) · #41 platform gaps · #42 cross-platform validation · #43 REST lab grounding ·
#44 CLI/UX polish · #45 QEMU watch-items.

Singles#46 user-settings P1 · #47 doctor · #48 config audit · #49 wizard
remediation · #50 evidence descriptor · #51 SSH transport · #52 sudo handling ·
#53 agent teaching · #54 error diagnostics · #55 multi-CHR examples.

Decisions owed (needs-decision) — #56 port-base randomness · #57 service-block
redesign · #58 config-schema split.

Docs in this PR

Verification

bun run check green (biome · tsc · markdownlint · cspell · validate-examples ·
shellcheck); git diff --check clean.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Reorganized the project backlog guidance to steer readers toward GitHub labels and a smaller set of key issue anchors instead of a static in-file index.
    • Added clearer references to open decisions in the design notes, linking them directly to related issues.
    • Updated an example README note to point to the relevant issue for tracking progress.

Copilot AI review requested due to automatic review settings July 3, 2026 16:48
@coderabbitai

coderabbitai Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

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

Next review available in: 57 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: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: b5d8084b-86ae-4c08-b95c-3e89fb163555

📥 Commits

Reviewing files that changed from the base of the PR and between 977c4e1 and 3d25a53.

📒 Files selected for processing (5)
  • BACKLOG.md
  • CLAUDE.md
  • CONTRIBUTING.md
  • DESIGN.md
  • examples/mndp/README.md
📝 Walkthrough

Walkthrough

Documentation updates replace static in-file backlog listings and cross-references with links to GitHub issues. BACKLOG.md restructures around label-based navigation and named anchor issues, while DESIGN.md and the MNDP README add direct issue links (#56, #57, #39) in place of prior text.

Changes

Documentation restructuring

Layer / File(s) Summary
Backlog index replaced with GitHub issue guidance
BACKLOG.md
Replaced the static migrated-issue list and curated open-items list with a "Browse open work" section linking to GitHub label facets and an "Anchors worth naming" section including a "Decisions owed" subsection.
Design and README issue references
DESIGN.md, examples/mndp/README.md
Added issue links #56 and #57 to DESIGN.md's open-question bullets, and updated the MNDP README friction note to reference issue #39 instead of BACKLOG.md.

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

Possibly related issues

🚥 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 docs-focused backlog refactor and the shift to a rot-free work map with filed issue references.
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 chore/file-curated-issues-37

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

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

Second half of #37: with the Issue->PR scheme merged (#38), triage
BACKLOG.md's "not yet filed" checklist into a curated set of GitHub
Issues (the "one list" to comment on) -- grouped, not 1-to-1:

- #39 anchors an optional centrs `exec` passthrough (needs-decision) and
  folds the centrs-owned cluster (exec soft-error, protocol-adapter,
  MAC-Telnet) as checklist items there, not as separate quickchr issues --
  they're more involved than QEMU-focused quickchr and drove centrs' design.
- #40 Windows, #41 platform-gaps, #42 cross-platform, #43 REST-grounding,
  #44 CLI/UX polish, #45 QEMU watch-items are triage umbrellas (research,
  done-when = break out sub-issues then close).
- #46-#55 crisp singles; #56-#58 the port/config needs-decision calls.

BACKLOG.md is now a rot-free map: browse-by-label query links for the live
list, explicit numbers only for grounding anchors (#39/#40/#56-#58).
Repoint the centrs MAC-Telnet note (examples/mndp) and the DESIGN port
open-questions to the real issues. Left the self-contained REST-timeout
rule in routeros-rest.instructions.md as-is (rules, not work pointers).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR completes the second half of the backlog→issues migration by converting the old “unfiled checklist” in BACKLOG.md into a rot-resistant work map that points to live GitHub label views, and by repointing a couple of existing docs to the newly filed grounding/decision issues.

Changes:

  • Slim BACKLOG.md into a work map with browse-by-label links plus a small set of “grounding anchor” issues.
  • Repointed existing documentation references from BACKLOG.md to the corresponding GitHub Issues (#39, #56, #57).
  • Kept decision/grounding pointers close to the relevant design notes (port layout decisions in DESIGN.md).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
examples/mndp/README.md Updates the MAC-Telnet note to reference the new concept/anchor issue (#39) instead of BACKLOG.md.
DESIGN.md Links the two open port-layout “needs-decision” items directly to issues #56 and #57.
BACKLOG.md Replaces the stale per-item list with label-based browsing links and a short set of explicitly named anchor issues.

@mobileskyfi
mobileskyfi force-pushed the chore/file-curated-issues-37 branch from 977c4e1 to 3d25a53 Compare July 3, 2026 16:49
@mobileskyfi
mobileskyfi merged commit fe641d3 into main Jul 3, 2026
7 of 9 checks passed
@mobileskyfi
mobileskyfi deleted the chore/file-curated-issues-37 branch July 3, 2026 16:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants