Skip to content

chore: remove aws-dev-toolkit plugin - #212

Open
rsmets wants to merge 7 commits into
mainfrom
chore/deprecate-aws-dev-toolkit
Open

chore: remove aws-dev-toolkit plugin#212
rsmets wants to merge 7 commits into
mainfrom
chore/deprecate-aws-dev-toolkit

Conversation

@rsmets

@rsmets rsmets commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Removes the aws-dev-toolkit plugin per the 2026-08-03 deprecation decision (shelmes@ handoff).

What changed

  • Deleted solution-architecture/plugins/aws-dev-toolkit/ (38 skills, 11 agents, 104 files)
  • Removed the aws-dev-toolkit entry from the startups-for-aws marketplace. Required: its source pointed at ./solution-architecture/plugins/aws-dev-toolkit, so leaving the entry would give a listing whose path no longer resolves
  • Updated the root and solution-architecture/ READMEs to point users to AWS Startup Advisor for startup-specific guidance and Agent Toolkit for AWS (aws configure agent-toolkit) for general-purpose guidance

Net: 3 files modified, 104 deleted.

Why nothing was ported

The plugin's skills and agents were overwhelmingly general-purpose AWS engineering guidance, which Agent Toolkit for AWS now owns. That duplication is precisely what drove the deprecation, so porting any of it would re-import the overlap. The startup lens belongs to AWS Startup Advisor.

Migration skills (migration-gcp-to-aws, migration-azure-to-aws, migration-apprunner-to-ecs-express) are being consolidated with Startups-Migrate under StartupEngBlend-3027 rather than ported here. hipaa-assistant is addressed by the separate compliance-agent initiative.

Why removing the source now is safe

Deleting the source would normally destroy the only channel for notifying existing users, so ordering matters. That notice has already landed:

  1. The deprecation notice merged into the served copy at chore: deprecate aws-dev-toolkit aws-samples/sample-claude-code-plugins-for-startups#10, released as v0.4.0
  2. The official marketplace advanced its pinned SHA to that content (abdf867305a3889e, bump(aws-dev-toolkit): abdf8673 → 05a3889e anthropics/claude-plugins-official#5238, merged)

So installed users receive the deprecation notice on their next /plugin update regardless of this removal.

Note: the plugin listing description at claude.com/plugins/aws-dev-toolkit is Anthropic-side metadata and is not affected by this PR. Updating that text and delisting the entry both require the Anthropic contact, as neither is self-serve for non-members.

Follow-ups, deliberately not in this PR

  • The replacement plugin for solution-architecture/
  • The contribution gate (three-criteria review agent plus its CI actuator) that keeps general-purpose content from re-accumulating in this folder

Per the 2026-08-03 deprecation handoff (shelmes@).

Item 1: Plans/aws-dev-toolkit-deprecation/PORT_DECISION.md records the
port-nothing-wholesale decision with all 38 skills bucketed A/B/C/D.
Bucket C defers to Startups-Migrate (StartupEngBlend-3027); hipaa-assistant
defers to the separate compliance-agent initiative.

Item 3: deprecation messaging added to the canonical aws-dev-toolkit copy
and the startups-for-aws marketplace entry. New replacement plugin
aws-startups-solution-architecture scaffolded with zero ported skills, so
no Agent Toolkit overlap is carried forward. The old plugin directory is
retained for now: deleting it before the notice reaches users would
destroy the only notice channel. Deletion is sequenced in the runbook.

Item 4: contribution gate. solution-architecture/agents/contribution-gate.md
enforces the three criteria (all must pass). .github/workflows/
contribution-gate.yml is the actuator for the deterministic part, requiring
audience: startup plus a startup keyword on contributed SKILL.md files.
Without the workflow the gate would be prose only and the overlap loop that
caused this deprecation would stay unbroken.

Item 5: DELIST_RUNBOOK.md sequences notice-then-delist across all three
marketplaces and documents the two-divergent-pin blocker.

No deprecation messaging was added to aws-startup-advisor, per the meeting
constraint. Not pushed.
@rsmets
rsmets requested review from a team as code owners August 11, 2026 21:42
Ray Smets and others added 5 commits August 11, 2026 14:44
The prior runbook claimed the official directory pinned an unrelated git
lineage (rsmets/startup-virtual-sa at bdfc8aa) with no common ancestor to
the aws-samples fork. That was wrong: it came from reading a local clone of
claude-plugins-official that was ~2,970 commits stale. Verified against
live upstream main, the entry pins aws-samples at abdf867, exactly as the
handoff doc stated.

Two further corrections:

- Advancing the pinned sha is NOT a support request. bump-plugin-shas.yml
  runs a nightly sweep over all SHA-pinned entries (discover_bumps.py, no
  allowlist) and opens a self-merging bump PR. Our entry qualifies on
  ref/path, so the pin advances automatically now that PR #10 is merged.
- Changing the entry description is NOT self-serve, which the prior
  runbook assumed as a mitigation. close-external-prs.yml auto-closes
  non-member PRs that modify or remove entries; only additions are in
  scope. Description change and delisting both need the Anthropic contact.

Also updates Step 2 status to reflect PR #10 merged at 05a3889.
Per the 2026-08-03 deprecation decision (shelmes@ handoff), aws-dev-toolkit
is deprecated rather than renamed. Its skills and agents were overwhelmingly
general-purpose AWS engineering guidance that Agent Toolkit for AWS owns, and
that overlap is what drove the deprecation. Nothing was ported.

Removes:
- solution-architecture/plugins/aws-dev-toolkit/ (38 skills, 11 agents)
- the aws-dev-toolkit entry from the startups-for-aws marketplace, which
  pointed at the now-deleted path

Updates the root and solution-architecture READMEs to point users to AWS
Startup Advisor for startup-specific guidance and Agent Toolkit for AWS for
general-purpose guidance.

The deprecation notice already reached installed users through the served
copy in aws-samples/sample-claude-code-plugins-for-startups (PR #10, released
as v0.4.0), whose pinned SHA in the official marketplace has been advanced,
so removing the source here no longer strands anyone.

The replacement plugin and the contribution gate follow in separate PRs.
@rsmets rsmets changed the title chore: deprecate aws-dev-toolkit, add contribution gate chore: remove aws-dev-toolkit plugin Aug 13, 2026
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.

2 participants