Skip to content

docs: add crisis learning examples to ai-provider-agnosticism principle#936

Open
atxtechbro wants to merge 2 commits intomainfrom
docs/add-crisis-learning-ai-provider-agnosticism-933
Open

docs: add crisis learning examples to ai-provider-agnosticism principle#936
atxtechbro wants to merge 2 commits intomainfrom
docs/add-crisis-learning-ai-provider-agnosticism-933

Conversation

@atxtechbro
Copy link
Copy Markdown
Owner

Summary

Enhances the ai-provider-agnosticism principle with real crisis learning examples from Claude 500 errors and Amazon Q resilience testing.

Changes

Crisis Learning Examples

  • Added concrete Claude 500 error → Amazon Q switch story
  • Real bash command examples showing the crisis and solution

ROI Mathematics

  • 2880x productivity preservation (4 hours downtime vs 5 second switch)
  • Actual measured impact from real service outage

Implementation Timeline

  • Crisis-to-solution in 30 minutes under pressure
  • Step-by-step breakdown from detection to full resilience

Template for Future Crises

  • "Never let a crisis go to waste" pattern
  • Provider diversity and symmetric configuration principles
  • Crisis-driven innovation insights

Principle Validation

  • Systems stewardship under pressure
  • Real-world proof of architecture resilience

Why This Matters

  • Shows principle validated under fire
  • Provides template for future crises
  • Demonstrates quantifiable business value
  • Real numbers make case for provider diversity

Closes #933

Test plan

  • Enhanced documentation with concrete examples
  • Maintained existing principle structure and relationships
  • Added crisis learning section with ROI math
  • Validated timeline and implementation details

…cism

- Add concrete Claude 500 error → Amazon Q resilience story
- Include ROI math: 2880x productivity preservation (4 hours vs 5 seconds)
- Document crisis-to-solution timeline (crisis to working system in 30 minutes)
- Add template for future crises and principle validation section
- Show real-world proof of provider agnosticism value under pressure

Principle: systems-stewardship
Principle: ai-provider-agnosticism
@amazon-q-developer
Copy link
Copy Markdown
Contributor

⏳ I'm reviewing this pull request for security vulnerabilities and code quality issues. I'll provide an update when I'm done

raise ValueError(f"Invalid file path: {file}")

# Check for company-notes patterns (security: prevent accidental leaks)
import fnmatch
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.

Description: The code uses broad library imports instead of importing specific required class, which consumes unnecessary memory and makes code maintenance harder by obscuring actual library usage. To optimize performance and improve code clarity, use targeted imports with 'from library import specific_class' syntax. Learn More https://docs.python.org/3/tutorial/modules.html.

Severity: Medium

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.

The remediation is made by replacing the broad import statement with a specific import of the required function from the fnmatch module. This optimizes performance and improves code clarity by explicitly showing which part of the module is being used.

Suggested change
import fnmatch
raise ValueError(f"Invalid file path: {file}")
# Check for company-notes patterns (security: prevent accidental leaks)
# from fnmatch import fnmatch # Used for pattern matching against filenames
blocked_patterns = []
for file in files:
# Normalize path separators

@amazon-q-developer
Copy link
Copy Markdown
Contributor

✅ I finished the code review, and left comments with the issues I found. I will now generate code fix suggestions.

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.

docs: add crisis learning examples to ai-provider-agnosticism principle

1 participant