chore: add agent skills pinning repository development conventions#2912
Merged
Conversation
Create relative symlinks from .claude/skills/ to the four agent skills in .agents/skills/, enabling Claude Code to discover and use them. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- dev-workflow: just linter runs ruff format which rewrites files; only the ruff check step is non-modifying - code-architecture: add asgi/, opentelemetry/, prometheus/ to the cross-broker public packages list
github-actions
Bot
added
the
documentation
Lancetnik
force-pushed
the
feat/agent-skills
branch
from
c2fe010 to
1a619c4
Compare
draincoder
approved these changes
Jun 9, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Adds four agent skills under
.agents/skills/(with symlinks in.claude/skills/for Claude Code auto-discovery) that pin this repository's development conventions for AI coding agents:_internalsplit, broker package anatomy (kafka as canonical reference), feature mirroring across brokers, strict-mypy typing rules, config and public-API conventionstests/brokers/base/), strict pytest markers, fixtures, in-memoryTestBrokervsconnectedreal-broker testing, how to run the suitedocs/docs/enpage layout,docs_srcsnippet embedding viamdx_include, snippet tests undertests/docs/, link/tab conventions, idiomatic FastStream example-code rulesThe skills are hybrid-style: hard rules + small inline examples + pointers to canonical files as the source of truth. Every factual claim (just recipes, marker expressions, mypy/ruff config, CI selections, package layouts) was verified against the current codebase. Symlinks are relative so they work from any checkout path; non-Claude tools can read the canonical
.agents/skills/copies directly.This replaces the conventions previously carried in the removed
.cursor/rules/faststream.mdc— its FastStream-usage rules are preserved inside the documentation-writing skill.Type of change
Checklist
🤖 Generated with Claude Code