Skip to content

docs(contributing): Known Issues Sweep references a known_issues/ directory this repo doesn't have #138

Closed

Description

@cristim

CONTRIBUTING.md's 'Known Issues Sweep' section (copied from the monorepo during the split) requires a known_issues/_.md entry plus a GitHub issue, but this repo has no known_issues/ directory; deferred work is tracked in GitHub issues only (CLAUDE.md says so since #137). Either update CONTRIBUTING.md to say GitHub issues are the tracker here, or create known_issues/ and move to that model. The same check applies to LeanerCloud/cloud-commitments-mcp, which also has no known_issues/. Raised by CodeRabbit on #137.

Activity

  1. cristim commented on Oct 17, 2026

    @cristim
    MemberAuthor

    Decision needed (one line): is the tracker GitHub issues only, or known_issues/ plus issues? CONTRIBUTING.md (~:242-308) still mandates known_issues/, CLAUDE.md says the directory does not exist, and it now does (known_issues/01_gcp_compute_nonroot_term.md, edited by open PR #307). Either way the fix is a 30-60 line docs edit. Marking status/needs-info.

  2. cristim commented on Oct 20, 2026

    @cristim
    MemberAuthor

    Question for @cristim (needed before #138 can move): CLAUDE.md on main says this repo has no known_issues/ directory and that GitHub issues are the tracker. But known_issues/01_gcp_compute_nonroot_term.md was added in abc5074 (#401), and CONTRIBUTING.md (~:242-308) still requires the directory model for the Known Issues Sweep.

    Options:

    1. GitHub issues only (default): move the content of known_issues/01_gcp_compute_nonroot_term.md into its issue (gcp compute: non-root populateRecommendationResources path still guesses the term #304), remove the directory, and rewrite the CONTRIBUTING.md sweep to use issues.
    2. Keep the directory: update CLAUDE.md to describe known_issues/ and keep CONTRIBUTING.md as is.

    Without an answer, I'll take option 1, which matches CLAUDE.md. [claude-cc-libs]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions