Skip to content

feat(databases-on-aws): add initial Aurora DSQL skill for Databases on AWS Plugin pt. 1#66

Merged
anwesham-lab merged 4 commits intoawslabs:mainfrom
anwesham-lab:feat/aurora-dsql-plugin
Mar 24, 2026
Merged

feat(databases-on-aws): add initial Aurora DSQL skill for Databases on AWS Plugin pt. 1#66
anwesham-lab merged 4 commits intoawslabs:mainfrom
anwesham-lab:feat/aurora-dsql-plugin

Conversation

@anwesham-lab
Copy link
Member

@anwesham-lab anwesham-lab commented Feb 26, 2026

Add databases-on-aws plugin with skill, MCP server configuration (DSQL disabled by default, AWS Knowledge enabled by default), hooks, and CLI scripts for building with serverless distributed SQL databases.

Per feedback, updated to match the Phase 1 proposal with Knowledge MCP lookup invocations for dynamic limit values (default fallbacks maintained for continuity, will update further to remove hardcoded values over time).

Broke down reference files further to conform to the 100 line limitations as well.

Related

RFC: #45

Changes

  • Plugin manifest (.claude-plugin/plugin.json): metadata, keywords, Apache-2.0 license
  • MCP config (.mcp.json): docs-only default, upgradeable to database operations via mcp-setup.md
  • Skill (skills/aurora-dsql/SKILL.md): 7 workflows covering schema creation, data migration, tenant isolation, access control, DDL table recreation, and MySQL-to-DSQL migration
  • Hooks (hooks/hooks.json): PostToolUse prompt hook for post-transact verification
  • CLI scripts (scripts/): 6 bash scripts for cluster lifecycle and data loading
  • Modularized references: DDL migrations (4 files), MySQL migrations (3 files), development guide, examples, language patterns, troubleshooting, onboarding, access control
  • Marketplace entry in .claude-plugin/marketplace.json
  • CODEOWNERS entry for plugins/aurora-dsql
  • Evaluations with trigger invocations, checks on the efficacy of the awsknowledge lookups for limits/values etc.

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.

@anwesham-lab anwesham-lab requested a review from a team February 26, 2026 00:50
@anwesham-lab anwesham-lab force-pushed the feat/aurora-dsql-plugin branch 6 times, most recently from 2fb98e6 to 02bf4c2 Compare February 26, 2026 05:01
@anwesham-lab anwesham-lab changed the title feat(aurora-dsql): add Aurora DSQL plugin feat(aurora-dsql): add initial Aurora DSQL plugin directly from DSQL Skill Feb 26, 2026
@anwesham-lab anwesham-lab linked an issue Feb 26, 2026 that may be closed by this pull request
@anwesham-lab anwesham-lab requested a review from a team February 26, 2026 07:03
gxjx-x
gxjx-x previously approved these changes Feb 27, 2026
Copy link
Member

@scottschreckengaust scottschreckengaust left a comment

Choose a reason for hiding this comment

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

Recommendation to place under aws-databases plugin

@scottschreckengaust
Copy link
Member

Please resolve conflicts also

@anwesham-lab anwesham-lab changed the title feat(aurora-dsql): add initial Aurora DSQL plugin directly from DSQL Skill feat(databases-on-aws): add initial Aurora DSQL skill for Databases on AWS Plugin pt. 1 Mar 18, 2026
@anwesham-lab anwesham-lab force-pushed the feat/aurora-dsql-plugin branch 2 times, most recently from f7026b8 to 95ed68e Compare March 18, 2026 14:15
@anwesham-lab anwesham-lab requested a review from gxjx-x March 18, 2026 14:16
@anwesham-lab anwesham-lab force-pushed the feat/aurora-dsql-plugin branch from 95ed68e to e9a3f0e Compare March 18, 2026 14:27
@anwesham-lab anwesham-lab force-pushed the feat/aurora-dsql-plugin branch from e9a3f0e to 0fef241 Compare March 18, 2026 14:31
@anwesham-lab anwesham-lab requested a review from a team as a code owner March 18, 2026 14:31
@anwesham-lab anwesham-lab dismissed scottschreckengaust’s stale review March 18, 2026 17:14

addressed this specific requested change, have fresh reviews to address from latest comments

@anwesham-lab
Copy link
Member Author

anwesham-lab commented Mar 18, 2026

Lines 222-238 of SKILL.md are nearly a verbatim copy of the Best Practices in development-guide.md:7-27. The SKILL.md should reference the development guide rather than duplicating it.

This was intentional. When I ran invocation evaluations, I found that the skill was frequently skipping over languages.md or the development guide or would lose context on these top level requirements. The best practices are rules I want to always be paged into the skill regardless of using the development guide. We had similar consideration for removing from the development guide, but then the skill frequently missed references where it should recall use of the connectors or the right IAM structure inline based on that content alone. The intersectionality is what led to the duplication of these best practices in two locations. I'll adapt the load in section, specifically the contains to try to explicitly incorporate everything referred to in best practices, so it can be removed, but I'm testing some trigger evals to make sure I still get the desired flow.

Looking over & addressing other feedback though.

@anwesham-lab anwesham-lab force-pushed the feat/aurora-dsql-plugin branch from 0fef241 to b34a541 Compare March 18, 2026 17:41
@anwesham-lab
Copy link
Member Author

All feedback addressed in latest force push.

@anwesham-lab anwesham-lab force-pushed the feat/aurora-dsql-plugin branch 5 times, most recently from 925348c to 040ada9 Compare March 18, 2026 19:29
Copy link
Member

@scottschreckengaust scottschreckengaust left a comment

Choose a reason for hiding this comment

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

upon determining where not-to-be-cloned items go

@anwesham-lab
Copy link
Member Author

anwesham-lab commented Mar 18, 2026

have tentatively moved evals to root level tools folder in latest commit, but we can consider maintaining evals locally. I think the visibility is good and follows stronger practices, but with the claude invocations, it does require being semgrep ignored.

anwesham-lab and others added 4 commits March 19, 2026 09:37
Add Aurora DSQL plugin with skill, MCP server config,
hooks, and CLI scripts for managing serverless distributed
SQL databases with PostgreSQL compatibility.

Plugin components:
- Skill with 7 workflows (schema, migration, tenant
  isolation, access control, DDL recreation, MySQL migration)
- Docs-only MCP config (upgradeable to database operations)
- PostToolUse hook for post-transact verification
- 6 CLI scripts for cluster management and data loading
- Modularized references: ddl-migrations (4 files),
  mysql-migrations (3 files), plus development guide,
  examples, language patterns, troubleshooting, onboarding,
  and access control

Closes awslabs#45

Co-authored-by: anwesham-lab <64298192+anwesham-lab@users.noreply.github.com>
Collapse CLI Scripts listing and Workflow 5 (Scoped Roles) into concise
pointers to their reference files, reducing upfront context without
losing discoverability. These sections duplicated content the agent
would naturally reach via access-control.md and scripts/README.md.

Co-authored-by: anwesham-lab <64298192+anwesham-lab@users.noreply.github.com>
Renames aurora-dsql plugin to databases-on-aws as the top-level plugin
for the AWS database portfolio. Migrates the DSQL skill into
skills/dsql/ within the new plugin structure.

Key changes:
- Rename plugin from aurora-dsql to databases-on-aws
- Split oversized reference files per Agent Skills spec (<100 lines)
  into subdirectories: auth/, examples/, platforms/, tools/
- Add AWS Knowledge MCP (awsknowledge) for verifying numeric limits
  with inline delegation hints in authoritative reference files
- Add explicit Table Recreation Pattern warning for unsupported DDL
  (ALTER COLUMN TYPE, DROP COLUMN, DROP CONSTRAINT)
- Add automated eval harness (triggering + functional with assertions)
- Update marketplace.json, CODEOWNERS, and .mcp.json

Co-authored-by: anwesham-lab <64298192+anwesham-lab@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Move evals from plugins/databases-on-aws/evals/ to tools/evals/databases-on-aws/
so eval files aren't shipped to end users when the plugin is installed
(claude --plugin-dir ships the entire git-tracked directory tree).

- Update .semgrepignore pattern to match new nested path
- Fix broken URL (anthropics/agent-skills -> anthropics/skills)
- Add plugin install command to evals README
- Document evals/ directory structure in AGENTS.md under tools/

Co-authored-by: anwesham-lab <64298192+anwesham-lab@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
@anwesham-lab anwesham-lab force-pushed the feat/aurora-dsql-plugin branch from 8bb7304 to d6e6113 Compare March 19, 2026 16:37
@anwesham-lab anwesham-lab dismissed scottschreckengaust’s stale review March 19, 2026 16:38

Discussed offline and moved evals into root-level tools directory.

Copy link
Contributor

@theagenticguy theagenticguy left a comment

Choose a reason for hiding this comment

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

Looks good. All prior review feedback (hook matcher mismatch, loader.sh --version parsing, predictable temp files, README update, typos, evals location) has been addressed. CI green, clean structure, sensible defaults (DSQL MCP disabled by default). Nice eval harness addition.

@anwesham-lab anwesham-lab added this pull request to the merge queue Mar 24, 2026
Merged via the queue into awslabs:main with commit 568a551 Mar 24, 2026
22 checks passed
@anwesham-lab anwesham-lab deleted the feat/aurora-dsql-plugin branch March 24, 2026 16:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

RFC: DSQL Agent Plugin

5 participants