Skip to content

docs: stop hardcoding the artifact count in CLAUDE.md - #90

Open
chitcommit wants to merge 1 commit into
mainfrom
fix/stale-artifact-count
Open

chitcommit wants to merge 1 commit into
mainfrom
fix/stale-artifact-count

Conversation

@chitcommit

Copy link
Copy Markdown
Contributor

CLAUDE.md asserted 104 capabilities in three places. marketplace.json
holds 106. The number was true when written and stopped being true the
moment an artifact was added.

Why this is not cosmetic

On #89, CodeRabbit read those lines as Coding guidelines and raised a
Major / Data Integrity finding:

The catalog currently contains 106 artifact IDs with unique IDs, so the
/market inventory is oversized. Remove the two extraneous artifacts.

Following it would have deleted two real, live artifacts to make reality
agree with a stale sentence. The reviewer reasoned correctly from a false
premise, and this file was the premise.

That finding also blocked #89 from merging — required_conversation_resolution
is enabled on main, so an unresolved thread blocks regardless of whether the
thread is correct. #89 was merged with --admin, i.e. past the finding rather
than through it. Removing the false premise is what stops that recurring.

The fix

Delete the count; do not replace it with 106, which would just reset the same
trap. The invariant is already mechanized:
scripts/check-overlay-coverage.sh asserts marketplace.json and
capabilities.generated.json project the same id set at whatever size — and it
is what caught the genuinely missing skill-hygiene record on #89.

Validation

Docs-only change; no script or manifest touched. Full local gate run on #89's
head (which includes this content): coverage 106/106, §16 schema, provenance
verify, source freshness, lint-plugins, test-plugins 86/86, dispatch audit
119 cells / 0 drift.

Related: #89, chittyfoundation/chittygov#29.

CLAUDE.md asserted "104 capabilities" in three places. marketplace.json holds
106. The number was correct when written and stopped being true the moment an
artifact was added — which is what a count in prose always does.

This was not cosmetic. CodeRabbit cited these lines as "Coding guidelines" on
PR #89 and raised a Major / Data Integrity finding instructing:

  "The catalog currently contains 106 artifact IDs with unique IDs, so the
   /market inventory is oversized. Remove the two extraneous artifacts."

Following it would have deleted two real, live artifacts to make reality agree
with a stale sentence. The reviewer was reasoning correctly from a false
premise, and the premise was this file.

The real invariant is already mechanized and needs no restating:
scripts/check-overlay-coverage.sh asserts marketplace.json and
capabilities.generated.json project the same id set, whatever its size. That
gate is what caught the genuinely missing skill-hygiene record on #89.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EtosSqJ6sL5dMyeHfkNrTe
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@coderabbitai

coderabbitai Bot commented Aug 3, 2026

Copy link
Copy Markdown

Warning

Review limit reached

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

Next review available in: 39 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: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9f6c5b99-b6e0-4d2e-988b-f743084f6b22

📥 Commits

Reviewing files that changed from the base of the PR and between 66d77f0 and a8538b5.

📒 Files selected for processing (1)
  • CLAUDE.md

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.

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.

1 participant