Skip to content

feat(readiness): Add shared AWS program library to portfolio TDs#54

Draft
lusoal wants to merge 1 commit into
aws-samples:mainfrom
lusoal:feat/update-readiness-analysis-programs
Draft

feat(readiness): Add shared AWS program library to portfolio TDs#54
lusoal wants to merge 1 commit into
aws-samples:mainfrom
lusoal:feat/update-readiness-analysis-programs

Conversation

@lusoal

@lusoal lusoal commented Jun 10, 2026

Copy link
Copy Markdown
Contributor

Introduce a shared AWS Program & GTM Library as a reference file and wire it into the two portfolio readiness Task Definitions so the analysis agent can recommend relevant AWS programs in the "Next Steps" section of reports.

  • Add readiness-analysis/references/program-library.md: 88 programs (35 Tier 1 detailed incl. 3 ARA agentic anchors, 53 Tier 2 compact) with signal patterns, qualification criteria, prioritization, grouping, and status filtering. Aligns trigger vocabulary to actual ARA/MOD findings.
  • Wire portfolio ARA Step 7 and portfolio MOD Step 9 to load the library; replace inline program catalogs with library references.
  • Move AI DLC, AXE, and Innovation EBA out of the portfolio ARA TD into the library as ARA anchor programs.
  • Group recommendations Funded -> Engagement -> GTM, cap at 3-5, and never expose the internal MOD 1-4 score.
  • Update both portfolio HTML visual contracts to render the full grouped library set with a Group column.
  • Add per-repo ARA/MOD pointer notes clarifying program recommendations are portfolio-level only; remove hardcoded program names from the per-repo ARA HTML contract.
  • Fix stale portfolio TD filenames in the README directory tree and table

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

Introduce a shared AWS Program & GTM Library as a reference file and wire
it into the two portfolio readiness Task Definitions so the analysis agent
can recommend relevant AWS programs in the "Next Steps" section of reports.

- Add readiness-analysis/references/program-library.md: 88 programs (35
  Tier 1 detailed incl. 3 ARA agentic anchors, 53 Tier 2 compact) with
  signal patterns, qualification criteria, prioritization, grouping, and
  status filtering. Aligns trigger vocabulary to actual ARA/MOD findings.
- Wire portfolio ARA Step 7 and portfolio MOD Step 9 to load the library;
  replace inline program catalogs with library references.
- Move AI DLC, AXE, and Innovation EBA out of the portfolio ARA TD into
  the library as ARA anchor programs.
- Group recommendations Funded -> Engagement -> GTM, cap at 3-5, and never
  expose the internal MOD 1-4 score.
- Update both portfolio HTML visual contracts to render the full grouped
  library set with a Group column.
- Add per-repo ARA/MOD pointer notes clarifying program recommendations
  are portfolio-level only; remove hardcoded program names from the
  per-repo ARA HTML contract.
- Fix stale portfolio TD filenames in the README directory tree and table.
@aritnag123

Copy link
Copy Markdown

Tested the updated portfolio MOD TD from PR #54. Programs are showing up correctly ✅

Setup:

  • Pushed the portfolio-mod TD + program-library.md (as document_references/) to my personal registry
  • Ran 2 per-repo MOD analyses (PHP monolith fixture + books-api), then the portfolio TD

Results:

  • 4 programs recommended from the library, grouped correctly:
      - Funded: AppMod Assessment, SHIP
      - Engagement: Immersion Days
      - GTM: Agentic-led Modernization Sales Play
  • Each recommended_actions[] entry has group field ✅
  • Capped within 3-5 range ✅
  • No internal MOD 1-4 scores exposed ✅
  • Per-repo reports clean (no program names, just pointer to portfolio TD) ✅

Notes for others testing:

  • The TD file must be named transformation_definition.md, references go in document_references/ (not references/)
  • Portfolio TDs require minimum 2 per-repo reports or they'll fail with entry criteria error
  • Use -x -t flags for non-interactive execution

LGTM from my side 👍

aritnag123 added a commit to aritnag123/aws-transform-custom-samples that referenced this pull request Jun 30, 2026
Integrate Kevin Shin's updated program catalog (Jun 15, 2026) into the
shared AWS Program & GTM Library while maintaining compatibility with
the portfolio ARA and MOD Task Definition interfaces.

Changes from Kevin's update:
- Add new programs: MMA Workshop, AWS Modernization Assurance (AMA),
  AWS-Funded ISV Tooling, Activate4GF, IW Programs, RDS Cost Assessment,
  DBC, DBOLA, AgentStorming Workshop, AWS AI League
- Add self-service resources: Connected Community, Skill Builder,
  Workshop Catalog with finding-based mapping table
- Update AI DLC with expanded signal patterns and Kiro reference
- Add assessment overlap rule and EBA vs AML rule
- Add self-service alternative rule for SMB/startup customers

Adaptations for PR aws-samples#54 interface compatibility:
- Restructure from 4 groups to 3 (Funded Programs / Engagement Models /
  GTM Motions) matching JSON schema and HTML visual contracts
- Add back AXE and Innovation EBA as ARA anchor programs
- Maintain 'Agentic Enablement Programs (ARA Anchors)' section
- Add [ARA]/[MOD]/[ARA+MOD]/[ARA-anchor] tags to all programs
- Fix 'Significant Remediation Required' -> 'Remediation Required'
- Fix ARA dimension vocabulary (no Blocked/Needs Work in ARA signals)
- Maintain 'Mapping findings to triggers' vocabulary alignment section
- Add program status markers (Active/Retiring/Launching/Pilot)
- Expand Agent Reasoning Checklist to 14 items

Total programs indexed: 42 (Tier 1: 34, Tier 2: 8)

Tested (structural validation):
- [PASS] ARA TD section references resolve (ARA Anchors, Mapping, Agent Rules)
- [PASS] JSON group schema matches (3 groups only, no 4th group)
- [PASS] ARA vocabulary correct (profiles, dimensions, no Blocked/Needs Work)
- [PASS] MOD vocabulary correct (7 pathways, score_rating, no internal scores)
- [PASS] All programs referenced in both portfolio TDs exist in library
- [PASS] Selection rules aligned (cap 3-5, sequencing, Retiring exclusion)
- [PASS] File integrity (no merge conflicts, 494 lines, clean diff)

Tested (live execution — portfolio MOD, us-east-1):
- Input: 3 per-repo MOD reports (Netflix/eureka, ToolJet, conductor-oss)
- [PASS] 5 programs recommended from updated library:
    Funded: AppMod PoC Funding, Well-Architected Review
    Engagement: EBA, Immersion Days
    GTM: AWS Skill Builder
- [PASS] Grouped correctly (Funded Programs -> Engagement Models -> GTM Motions)
- [PASS] recommended_actions[] entries all have 'group' field
- [PASS] Capped within 3-5 range (exactly 5)
- [PASS] No internal MOD 1-4 scores exposed in programs section
- [PASS] New library programs surfaced (Immersion Days, Skill Builder, AppMod PoC)
- [PASS] HTML artifact generated (19KB) with grouped program rendering

Tested (live execution — portfolio ARA, us-east-1):
- Input: 3 per-repo ARA reports (Netflix/eureka, ToolJet, FlowiseAI/Flowise)
- [PASS] 4 programs recommended from updated library:
    Funded: AI Assessment Program
    Engagement: AI DLC, SHIP
    GTM: AWS Transform Custom
- [PASS] Grouped correctly (Funded Programs -> Engagement Models -> GTM Motions)
- [PASS] recommended_actions[] entries all have 'group' field
- [PASS] Capped within 3-5 range (exactly 4)
- [PASS] No internal scores exposed in programs section
- [PASS] ARA anchor program (AI DLC) triggered correctly
- [PASS] SHIP triggered from Auth dimension findings (correct vocabulary)
- [PASS] HTML artifact generated (15KB) with grouped program rendering
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