Skip to content

BB-916: Shared Claude Code skeleton setup for BNaaS D1 - #2887

Open
anurag4DSB wants to merge 3 commits into
epic/S3C-10971-bnaas-d1from
improvement/BB-916-shared-claude-setup
Open

anurag4DSB wants to merge 3 commits into
epic/S3C-10971-bnaas-d1from
improvement/BB-916-shared-claude-setup

Conversation

@anurag4DSB

@anurag4DSB anurag4DSB commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Note to reviewers: Additions to only .claude, plus .gitignore entries for local .claude work files and a lint_md change that skips .claude/. This is just skeleton, we will improve this as and when we needed

Intent: why does this change exist?

This is a first shared Claude Code setup for D1, so that the sessions of Anurag and Taylor follow the same rules. It is a skeleton, and the team changes it to fit the work.

System impact: what's affected, including downstream?

Only .claude/, plus two .gitignore entries and one lint_md line in package.json that skips .claude/. A D1 session that follows the README install loads the setup.

Preserved behavior: what explicitly stays the same?

Backbeat code, tests and CI are untouched.

Intended change: what's different after this PR?

The setup holds seven team rules, the bnaas-reviewer agent and the bnaas-plan-pr skill. A hook refuses a git push until the CI review ran locally on that commit (Rule 7). Start with .claude/README.md.

Verification: how do we know this worked, or how would we know if it didn't?

A fresh session loads the setup, and the push gate passes 41 test cases. This branch went through the same local review before its push.

Comment thread .claude/skills/bnaas-plan-pr/SKILL.md Outdated
@codecov

codecov Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.21%. Comparing base (85aaab3) to head (2036d9d).

Additional details and impacted files

Impacted file tree graph
see 2 files with indirect coverage changes

Components Coverage Δ
Bucket Notification 85.50% <ø> (ø)
Core Library 86.86% <ø> (-0.36%) ⬇️
Ingestion 83.38% <ø> (ø)
Lifecycle 86.17% <ø> (ø)
Oplog Populator 89.48% <ø> (ø)
Replication 68.64% <ø> (ø)
Bucket Scanner 89.37% <ø> (ø)
@@                     Coverage Diff                     @@
##           epic/S3C-10971-bnaas-d1    #2887      +/-   ##
===========================================================
- Coverage                    81.36%   81.21%   -0.15%     
===========================================================
  Files                          209      209              
  Lines                        44236    44236              
===========================================================
- Hits                         35993    35928      -65     
- Misses                        8243     8308      +65     
Flag Coverage Δ
api:retry 14.59% <ø> (ø)
api:routes 14.61% <ø> (ø)
bucket-scanner 89.37% <ø> (ø)
ft_test:queuepopulator 17.42% <ø> (-1.23%) ⬇️
ingestion 20.57% <ø> (ø)
lib 12.90% <ø> (ø)
lifecycle 26.81% <ø> (-0.01%) ⬇️
notification 1.90% <ø> (ø)
oplogPopulator 0.45% <ø> (ø)
replication 25.27% <ø> (-0.01%) ⬇️
unit 67.44% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@anurag4DSB anurag4DSB changed the title BB-916: Shared Claude Code setup for BNaaS D1 BB-916: Shared Claude Code skeleton setup for BNaaS D1 Oct 14, 2026
Both developers need the same Claude Code setup on D1, and it lived in
one local checkout only. This adds it under .claude/ on the backbeat
epic. The final merge into development removes it.

- rules/bnaas-d1.md: team rules 1 to 6 (advisor and subagents, plan
  first, epic PRs, verification, Jira tracking, commits and releases).
- agents/bnaas-reviewer.md: a read-only reviewer for diffs and plans.
- skills/bnaas-plan-pr: commits an approved plan and opens a plan PR.
- settings.json: Fable as the advisor, plans/ as the plans folder.
- README.md: install for the one-repository and workspace layouts.
- plans/: the approved plans of this setup and of task 3.

.gitignore keeps settings.local.json and worktrees/ out of git.
Rule 7: before every push, run the review-pr skill of
scality-skills@scality-agent-hub on the branch. It is the skill that
the Code Review workflow runs on each PR. hooks/review-branch.sh runs
it in a headless session, in its local mode, and saves the result per
commit under the git dir. hooks/review-gate.sh, a PreToolUse hook on
Bash, refuses a git push until a saved review exists for the exact
commit being pushed.

The gate catches a forgotten review. It is not a security boundary,
and it fails closed on what it cannot check. The README covers the
plugin install and each refusal message, and the plan PR skill runs
the review before its push.
The files under .claude/ are prompts, rules and plans for Claude Code,
with long lines and front matter that mdlint refuses (MD013, MD041).
They live only on the BNaaS D1 epic and go away before the final merge,
together with this exclusion.
@anurag4DSB
anurag4DSB force-pushed the improvement/BB-916-shared-claude-setup branch from 267fe0d to 2036d9d Compare October 14, 2026 14:50

This branch has not been deployed

No deployments
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