Releases: ferdinandobons/AWSBestPracticesSkill
Releases · ferdinandobons/AWSBestPracticesSkill
Release list
v0.1.5
Changed
- Clarify README, GitHub Pages, LLM metadata, and plugin descriptions around the scenario-targeted answer flow: scenario-targeted practices when the user provides context, general production baseline when they do not, and no live web browsing for ordinary answers.
v0.1.4
Changed
- Add answer-style guidance to
SKILL.md: target recommendations to the user scenario when one is provided; otherwise give a general production baseline instead of dumping every practice.
v0.1.3
Changed
- Strengthen
SKILL.mdinstructions so ordinary best-practice answers use the local catalog and cite existing source URLs without opening AWS docs or doing live web searches. - Move the no-web instruction to the start of the skill description so it survives shortened skill descriptions, and clarify that source URLs should be copied from local Markdown instead of opened.
v0.1.2
Added
- GitHub Pages landing page under
docs/with SEO metadata, catalog coverage summary, extraction process, refresh process, install commands,robots.txt,sitemap.xml, andllms.txt. - GitHub Actions workflow to deploy the
docs/directory to GitHub Pages.
Changed
- Clarify in the README, skill router, plugin manifests, Pages site, and LLM metadata that this is an independent, unofficial project and not affiliated with or endorsed by AWS.
- Remove the orange
AWSbadge from the GitHub Pages header.
v0.1.1
[0.1.1] - 2026-07-05
Changed
- README quickstart: use the
claude plugin/codex pluginCLI syntax
consistently for both tools, and split usage into direct invocation
(/aws-best-practicesstandalone,/aws-best-practices:aws-best-practices
as a plugin, or referencingaws-best-practicesin a Codex CLI prompt) and
indirect invocation (asking a natural-language question, which triggers the
skill automatically).
v0.1.0
[0.1.0] - 2026-07-05
Added
- Repository skeleton:
SKILL.mdrouter,MAINTENANCE.md, CI. catalog.jsonsource of truth: 208 services across 23 categories + 9 general docs.scripts/check.pyvalidator + diff-checker (coverage, conformance, links,
baseline diff, index generation).GENERATE.md: a portable, tool-agnostic prompt for the generation loop,
copy-paste into any terminal coding agent's chat (Claude Code, Codex CLI,
etc.), no dependency on Claude Code's slash-command mechanism.- Full content generation: all 217 catalog entries (208 services + 9 general
docs) researched against official AWS documentation, each practice bullet
source-linked; verified withscripts/check.py --strict(0 errors) and a
full network link check (0 broken links across ~3,200 URLs). scripts/check.py --stale [category] [--stale-days N]: freshness check that
reads each file's trailinglast_revieweddate and flags entries missing it
or older than the threshold (default 180 days); surfaced as a non-blocking
summary line in the defaultcheck.pyrun too.REFRESH.md: a portable prompt (sibling ofGENERATE.md) for the periodic
maintenance pass. Diffscatalog.jsonagainst AWS's current service list
to catch new/renamed/retired services, then re-reviews entries flagged by
--staleagainst current official docs.- Catalog audit against the live AWS service list: added 20 services confirmed
missing (e.g. ROSA, Amazon File Cache, Amazon VPC Lattice, AWS Verified Access,
AWS Artifact, AWS Well-Architected Tool, Amazon Bedrock AgentCore). - Plugin installability for both Claude Code (
.claude-plugin/plugin.json+
.claude-plugin/marketplace.json) and Codex CLI (.codex-plugin/plugin.json.agents/plugins/marketplace.json), verified end to end with
claude plugin marketplace add/installandcodex plugin marketplace add/add. Manualgit cloneinto a skills directory remains as a backup
install method.
Changed
- Renamed catalog entries to match current official AWS product names: Amazon
GameLift → Amazon GameLift Servers; Amazon WorkSpaces Web → Amazon WorkSpaces
Secure Browser; Amazon AppStream 2.0 → Amazon WorkSpaces Applications; Route 53
Application Recovery Controller → Amazon Application Recovery Controller (ARC). - Recategorized AWS AppFabric (→ Business Applications) and Amazon Application
Recovery Controller (→ Networking & Content Delivery) to match AWS's current
product taxonomy.
Removed
- Dropped catalog entries for services confirmed fully retired by AWS: Amazon
QLDB, AWS OpsWorks, AWS RoboMaker, AWS IoT Analytics, AWS IoT Events. The
roboticscategory was removed as a result (RoboMaker was its only entry). - Dropped
_TEMPLATE.md: orphaned onceGENERATE.mdstarted embedding the
file format spec directly (self-contained by design), and unreferenced by
any other doc.