Skip to content

docs(aws-startup-advisor): name RDfA as an Azure discovery source - #474

Merged
leon1418 merged 2 commits into
aws:mainfrom
herosjourney:fix/azure-rdfa-discovery-guidance
Oct 20, 2026
Merged

leon1418 merged 2 commits into
aws:mainfrom
herosjourney:fix/azure-rdfa-discovery-guidance

Conversation

@herosjourney

Copy link
Copy Markdown
Contributor

Problem

#458 made a customer-supplied Resource Discovery for Azure (RDfA) report a real Discover producer, and Discover states that Azure Cost Management billing-export discovery is not implemented. The summaries a reader or agent loads first were not updated with that change:

  • azure-to-aws/SKILL.md's frontmatter still says Discover reads Terraform, the live az CLI, app code, and billing exports, and never names RDfA.
  • The same file's Defaults line calls billing exports a fallback, which contradicts Discover's "no billing fragment" statement.
  • The plugin README's Azure row and Discover bullet repeat the same omission.

Fix

Describe the sources Discover actually reads.

  • The skill description and Defaults now name RDfA archive parsing as supported and say billing-export discovery is not implemented.
  • The plugin README's Azure capability row and Discover bullet do the same. The GCP clause still says GCP reads billing exports.
  • A contract test pins both summaries so the next source change cannot leave them behind.

Scope

Docs and one test. No Discover behavior changes. RDfA parsing from #458 is unchanged.

This overlaps the Azure guidance rewrite already on #459. If this lands first, #459 should rebase those sentences rather than restore the old "billing exports, and not RDfA" wording.

Validation

  • pytest tests/test_azure_discovery_source_guidance.py — 2 passed.
  • markdownlint-cli2 on SKILL.md and README.md — 0 errors.

Type of Change

  • New plugin
  • New skill
  • Bug fix
  • Documentation update
  • CI/CD change
  • Other

Startup Advisor review checklist

By submitting this PR, I confirm that:

  • I have reviewed the full diff and understand all changes I am submitting.
  • I have tested my changes and confirmed they work as intended.
  • I have run the checks that cover this diff (the new contract test and markdown lint).
  • I have disclosed any known issues, limitations, or untested scenarios.

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

Made with Cursor

aws#458 made a customer-supplied RDfA report a real Discover producer and
left billing-export discovery unimplemented, but the skill description
and plugin README still listed billing exports as a source and never
mentioned RDfA.
@herosjourney
herosjourney requested review from a team as code owners October 20, 2026 17:58

@leon1418 leon1418 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

[🤖 AI review 🤖]

One blocking correction at 6e93252: shorten the Azure skill description to the 1,024-character limit while retaining RDfA support and the billing-export limitation. The current 1,126-character value fails tools/validate_spec.py locally and in Build CI.

Validation: 41 Azure contract tests passed; both changed Markdown files passed lint; plugin parity and git diff --check passed. Re-run spec validation and the summary tests after shortening the description.

Comment thread plugins/aws-startup-advisor/skills/azure-to-aws/SKILL.md Outdated
…r the 1024 limit

The RDfA naming edit pushed the azure-to-aws SKILL.md frontmatter description
to 1126 chars, failing the repo-root `build` check (`lint:spec`: description
over the 1024 limit). Trim to 1015 chars by dropping two redundant trigger
phrases ("move off Azure", "move Azure AI or agentic workloads to AWS") while
preserving the RDfA discovery-source mention (this PR's purpose) and the exact
"billing-export discovery is not implemented" wording the PR's own
test_azure_discovery_source_guidance.py pins. Root build and plugin CI
(467 tests) pass.
@leon1418
leon1418 added this pull request to the merge queue Oct 20, 2026
Merged via the queue into aws:main with commit ebdcd96 Oct 20, 2026
11 checks passed
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