Skip to content

Add shared Claude and Codex agents and skills - #1188

Merged
joe-clickhouse merged 1 commit into
mainfrom
joe-clickhouse/add-skills-and-agents
Nov 13, 2026
Merged

joe-clickhouse merged 1 commit into
mainfrom
joe-clickhouse/add-skills-and-agents

Conversation

@joe-clickhouse

@joe-clickhouse joe-clickhouse commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Checks in the agent definitions and repo skills so every checkout and worktree gets them without local setup.

  • Each agent in .claude/agents now has a matching one in .codex/agents, and every agent pins a model and reasoning effort for its job.
  • behavior-prober is now an ad hoc fuzzer. It reads the change, guesses where it is fragile, and tries to break it with boundary values, type combinations, round trips through the server, and comparisons across codecs, C extensions, and sync and async clients.
  • The old docs-sync reviewers are gone. docs-drift-reviewer covers that job, and it now has a Codex version.
  • create-pr, release-prep, and update-test-matrix are checked in under .claude/skills, with .agents/skills links so Codex sees them too.
  • Adds the SQLAlchemy and Alembic maps the reader agents rely on.
  • .gitignore now ignores only local files under .claude and .codex.
  • AGENTS.md tells agents in a new worktree to link the primary checkout's .server-src instead of cloning again.

Note

Low Risk
Documentation and agent configuration only; the only repo policy change is .gitignore and AGENTS.md worktree server-source handling.

Overview
This PR versions the repo’s AI agent toolchain so agents and skills ship with every clone instead of living only in ignored local dirs.

Agent and skill definitions land under .claude/agents/, .claude/skills/, and matching Codex configs in .codex/agents/, covering implementers, reviewers, fuzzing (behavior-prober), performance analysis, root-cause work, and source readers (ClickHouse server, SQLAlchemy, Alembic, generic Python packages, Rust/PyO3). Each definition specifies model and reasoning effort; clickhouse-server-reader is aligned with the newer escalation wording.

Navigation maps .agents/alembic-map.md and .agents/sqlalchemy-map.md support the dedicated reader agents, with symlinks from .agents/skills/ into the checked-in skills (create-pr, release-prep, update-test-matrix).

.gitignore no longer ignores all of .claude / .codex; it keeps local cruft ignored while tracking agents/ and skills/ (Codex: agents/ only).

AGENTS.md adds guidance to symlink .server-src and .server-ref from the primary worktree instead of re-cloning, and notes the Codex path for the server reader agent.

No changes to clickhouse_connect/ runtime code in this diff.

Reviewed by Cursor Bugbot for commit 7529ee5. Bugbot is set up for automated code reviews on this repo. Configure here.

Check in the agent definitions and repo skills so every checkout and
worktree gets them. Each Claude agent has a matching Codex agent with a
pinned model and reasoning effort. behavior-prober becomes an ad hoc
fuzzer. The docs-sync reviewers are replaced by docs-drift-reviewer.

@security-ai-gate-reviewer security-ai-gate-reviewer Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Automated approval by the AI review gate.

The required AI review gate concluded SUCCESS on 7529ee5, and this change touches no path that requires a human reviewer. This approval is posted by an automated identity (security-ai-gate-reviewer[bot]), not a human, and is bound to the evaluated commit. A new push dismisses it and re-evaluates.

repo=ClickHouse/clickhouse-connect pr=#1188 head=7529ee5c89c284190d4abf6c30985acf1d586b41

@joe-clickhouse
joe-clickhouse merged commit 9fa76e5 into main Nov 13, 2026
40 checks passed
@joe-clickhouse
joe-clickhouse deleted the joe-clickhouse/add-skills-and-agents branch November 13, 2026 04:21
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