Skip to content

Feat/agent skill extend commands api - #574

Open
uglide wants to merge 2 commits into
redis:masterfrom
uglide:feat/agent-skill-extend-commands-api
Open

uglide wants to merge 2 commits into
redis:masterfrom
uglide:feat/agent-skill-extend-commands-api

Conversation

@uglide

@uglide uglide commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

Note

Low Risk
Documentation-only agent skill and symlink; no production code, auth, or runtime behavior changes.

Overview
Adds an agent skill (extend-commands-api) that guides humans or automation through adding or extending NRedisStack Redis Stack module commands with evidence-first workflow (HLD, server PR, redis-cli), a change-type decision tree (A–E), and maintainer conventions (builders, CommandCategories, PublicAPI.Unshipped.txt, sync/async + standalone/cluster tests).

The skill defines supervised (plan + approval) vs unattended (RedisClientsBot-style parity) modes, including env vars, reporting requirements, and boundaries (no CI/version bumps in unattended runs). A symlink under .claude/skills/ points at the same content for Claude tooling.

No NRedisStack library or test code changes—only documentation for agents.

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

uglide added 2 commits October 1, 2026 13:13
NRedisStack had no agent instructions for adding commands. Add
.agents/skills/extend-commands-api/SKILL.md, with .claude/skills symlinked to
it as in Lettuce, modelled on the Jedis and Lettuce skills of the same name
and grounded in this repo's conventions:
- the module layout: interfaces with <seealso> docs, sync classes inheriting
  async, <Module>CommandBuilder returning SerializedCommand with a
  CommandCategory, and the Literals classes
- PublicAPI.Unshipped.txt, and Experiments for preview features
- tests: EndpointsFixture with AllEnvironments / StandaloneOnly,
  CreateKeyName for multi-key commands on cluster, SkipIfRedisTheory gating,
  and REDIS_VERSION
- dotnet format, plus FT.ALIASLIST (redis#518) as the worked example

Supervised (default) follows plan mode and approval. Unattended mode, used
only on `Mode: unattended` or CLIENT_SKILL_MODE=unattended, takes the HLD and
the endpoints from the automation. It runs the new theories against standalone
and cluster via REDIS_ENDPOINTS_CONFIG_PATH and reports counts per topology.
The automation's standalone and cluster now require passwords. endpoints.json
carries them per entry, EndpointConfig.CreateConnection applies them, and
the cluster probe authenticates.

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