Skip to content

docs(CLAUDE.md): add agent contributor instructions#260

Draft
bvacaliuc wants to merge 3 commits intonextfrom
bvacaliuc/agentic-knowledge
Draft

docs(CLAUDE.md): add agent contributor instructions#260
bvacaliuc wants to merge 3 commits intonextfrom
bvacaliuc/agentic-knowledge

Conversation

@bvacaliuc
Copy link

Summary

Adds a to the branch to guide
Claude agents (and other AI contributors) working on this repository.

Contents

  • Project orientation (institutional repo, src/ layout, pixi toolchain)
  • Branching model (next -> qa -> main) and naming conventions
  • CI/CD pipeline summary including the deploy-dev trigger on next merges
  • Pre-commit hook behaviour (ruff auto-fix, pixi-lock-check at pre-push)
  • Agent workflow: origin is read-only; human pushes {user}/ branches;
    Claude opens draft PRs via PAT; human promotes to ready after review
  • Cross-project GitHub Actions gotchas carried forward from prior work

Left as draft for human review before merging.

Generated with Claude Code

bvacaliuc and others added 2 commits February 22, 2026 14:59
Captures project orientation, branching model, CI/CD pipeline,
pre-commit setup, and the agreed agentic workflow:
- origin is read-only for Claude agents
- human pushes branches as bvacaliuc/{feature-description}
- Claude creates draft PRs via PAT after human push
- cross-project GitHub Actions gotchas (GITHUB_TOKEN anti-loop,
  workflow_dispatch check-run limitation)

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@codecov-commenter
Copy link

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 65.64%. Comparing base (9581482) to head (98b4397).

Additional details and impacted files
@@           Coverage Diff           @@
##             next     #260   +/-   ##
=======================================
  Coverage   65.64%   65.64%           
=======================================
  Files          37       37           
  Lines        7010     7010           
=======================================
  Hits         4602     4602           
  Misses       2408     2408           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@bvacaliuc bvacaliuc assigned backmari and unassigned backmari Feb 23, 2026
@bvacaliuc
Copy link
Author

Hold as draft PR for discussion. Primarily interested in evolving the bvacaliuc/agentic-knowledge branch until it is fully developed for this project.

- agentic-knowledge was meant to be {feature-description}
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.

3 participants