Skip to content

docs: refresh stale CLAUDE.md status banner (informal meta: waiver) - #205

Merged
jensholdgaard merged 1 commit into
mainfrom
docs/refresh-claude-banner
Jun 14, 2026
Merged

docs: refresh stale CLAUDE.md status banner (informal meta: waiver)#205
jensholdgaard merged 1 commit into
mainfrom
docs/refresh-claude-banner

Conversation

@jensholdgaard

@jensholdgaard jensholdgaard commented Jun 14, 2026

Copy link
Copy Markdown
Owner

What

Refreshes CLAUDE.md's stale top status banner.

Before → after

  • Before: "Status: draft. This is a greenfield project. Nothing has been implemented yet. … the first ten thousand lines …"
  • After: "Status: pre-release, under active RFC-driven development. The ingest path (OTLP → WAL → miner → Parquet) and the query path (logs DSL → DataFusion) are implemented and tested behind RFC acceptance gates; the performance thesis is being validated in docs/benchmarks.md. These directives exist to make sure every line is written with the same care as the first — and the hundred-thousandth."

The old banner was flatly false (10 crates implemented; RFC 0001/0007/0008 at terminal status). New wording mirrors the README status note and keeps the "same care" ethos.

Process

Per CLAUDE.md's footer, a change to it needs a meta: RFC + majority approval. This is a factual-staleness fix, not a directive change, and maintainer-requested — so it lands as an informal meta: RFC waiver recorded in the footer changelog (precedent: b50067d, the §6.2 "tests are specifications" bullet). Say the word if you'd prefer a formal RFC instead.

CLAUDE.md only; not under docs/, so no mdBook impact.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated project status documentation to reflect pre-release phase with RFC-driven development approach.
    • Added clarification on implemented data ingestion and query paths.
    • Added reference to performance benchmarking documentation.
    • Refreshed revision notes for accuracy.

The top banner said "Status: draft … greenfield … Nothing has been
implemented yet … the first ten thousand lines" — flatly stale: the
ingest + query stack is built and tested behind RFC acceptance gates,
RFC 0001/0007/0008 are at terminal status. Update it to "pre-release,
under active RFC-driven development" (mirroring the README status note),
keeping the same-care ethos.

Per CLAUDE.md's footer a change needs a meta: RFC + majority approval;
this is a factual-staleness fix (not a directive change) requested by the
maintainer, so it lands as an informal meta: RFC waiver recorded in the
footer changelog (precedent: b50067d, the §6.2 bullet).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jun 14, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 07526b15-6248-4f19-bb6c-70f7b610990e

📥 Commits

Reviewing files that changed from the base of the PR and between 0d9aa4f and 3bf2385.

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

📝 Walkthrough

Walkthrough

Two sections of CLAUDE.md are updated: the top Status banner is reworded from a generic draft description to a pre-release, RFC-driven development statement referencing implemented ingest and query pipelines, and the Last updated revision notes are reworded to describe the same-date banner refresh as an informal meta: RFC waiver.

Changes

CLAUDE.md Documentation Update

Layer / File(s) Summary
Status banner and revision notes
CLAUDE.md
Status block changed from generic draft language to "pre-release, under active RFC-driven development," naming the OTLP→WAL→miner→Parquet and logs DSL→DataFusion paths as implemented and RFC-gated; Last updated notes reworded to characterize the same-date refresh as an informal meta: RFC waiver with maintainer precedent reference.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • jensholdgaard/ourios#203: Modifies the same CLAUDE.md governance metadata sections — Status banner and Last updated revision notes — as part of the same meta-RFC waiver/acceptance process.

Poem

🐇 A banner once stale now gleams anew,
RFC gates hold the pipelines true,
Ingest and query, both tested and set,
A meta: waiver, no need to fret.
The warren is pre-release — hop along! 🌿

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: refreshing a stale status banner in CLAUDE.md and noting it proceeds as an informal meta waiver.
Description check ✅ Passed The description provides a comprehensive explanation with before/after comparisons and process justification, but lacks several checklist items (cargo fmt, clippy, tests, etc.).
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.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/refresh-claude-banner

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 and usage tips.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates the root CLAUDE.md status banner to reflect the project’s current maturity (pre-release, RFC-driven development) rather than the previously stale “draft / nothing implemented” wording.

Changes:

  • Replaces the top-of-file status banner with current ingest/query stack status and a pointer to docs/benchmarks.md.
  • Records the banner refresh in the CLAUDE.md footer changelog as an informal meta: RFC waiver (per described precedent).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@jensholdgaard
jensholdgaard merged commit bd05edf into main Jun 14, 2026
13 checks passed
@jensholdgaard
jensholdgaard deleted the docs/refresh-claude-banner branch June 14, 2026 20:53
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