Skip to content

Add 9 new Green AI patterns to the catalogue#407

Open
russelltrow wants to merge 18 commits into
Green-Software-Foundation:mainfrom
russelltrow:main
Open

Add 9 new Green AI patterns to the catalogue#407
russelltrow wants to merge 18 commits into
Green-Software-Foundation:mainfrom
russelltrow:main

Conversation

@russelltrow

@russelltrow russelltrow commented Jun 16, 2026

Copy link
Copy Markdown
Member

Summary

This PR contributes 9 new green software patterns focused on AI and ML workloads, authored by Naveen Balani. The patterns cover the full AI lifecycle — from development decisions through to runtime operations — and are structured according to the GSF pattern template.

New patterns

Development

Architecture

Operations

  • operations/carbon-aware-ai-scheduling.md — Reduce the carbon impact of AI workloads by running them in cloud regions with lower grid carbon intensity and scheduling deferrable jobs during periods of high renewable energy availability.

Pattern structure

Each pattern follows the standard GSF template and includes:

  • ## Description — problem context and motivation
  • ## Solution — actionable guidance
  • ## SCI Impact — mapping to the E, I, M, and R factors of the SCI equation
  • ## Cost Impact — compute, infrastructure, and trade-off considerations
  • ## Assumptions — preconditions for the pattern to apply
  • ## Considerations — trade-offs and caveats
  • ## References — citations and further reading

All patterns include a description field in YAML front matter for catalogue indexing, and personas are aligned to the official GSF persona list.

Note on patterns 4A and 4B

The ML frameworks and agent orchestration patterns were originally scoped as a single pattern. Following a review with Naveen Balani, they were split into two focused patterns — one covering execution engine selection (4A) and one covering workflow design for agentic systems (4B) — as the two decisions are made by different personas at different points in development.

Test plan

  • Review YAML front matter is valid for all 9 files
  • Confirm section order matches GSF template: Description → Solution → SCI Impact → Cost Impact → Assumptions → Considerations → References
  • Verify patterns render correctly in the Docusaurus site
  • Confirm lifecycle category assignments (Development / Architecture / Operations) are correct for each pattern
  • Confirm all personas are drawn from the official GSF persona list
  • Review SCI Impact mappings for accuracy against the SCI specification

🤖 Generated with Claude Code

russelltrow and others added 13 commits January 15, 2026 16:49
Signed-off-by: Russell Trow <russell@greensoftware.foundation>
Signed-off-by: Russell Trow <russell@greensoftware.foundation>
Updated base URL format for Docusaurus configuration.

Signed-off-by: Russell Trow <russell@greensoftware.foundation>
Signed-off-by: Russell Trow <russell@greensoftware.foundation>
Signed-off-by: Russell Trow <russell@greensoftware.foundation>
Signed-off-by: Russell Trow <russell@greensoftware.foundation>
Signed-off-by: Russell Trow <russell@greensoftware.foundation>
Updated GH deploy workflow to allow manual runs

Signed-off-by: Russell Trow <russell@greensoftware.foundation>
Remove several legacy AI/architecture pages and replace them with reorganized, up-to-date guidance. Adds new system-topology patterns (efficient-hardware, on-demand-execution for agent workloads, run-ai-models-edge), new development docs (right-sized models, optimize data storage), and an operations doc for carbon-aware scheduling. Also updates pre-trained-transfer-learning metadata/content (author and expanded guidance). Consolidates and modernizes AI sustainability guidance and authorship (Naveen Balani).
Rename file from 'Use right-sized and energy-efficient AI models .md' to 'right-sized-energy-efficient-ai-models.md' to remove trailing space and normalize the filename to kebab-case. No content changes were made; this improves consistency and prevents issues with linking and tooling that don't handle spaces well.
…vements

- Add ## Cost Impact section to all 7 AI patterns (between SCI Impact and Assumptions)
- Fix stray trailing quote in pattern-02 h1 title
- Strengthen edge deployment assumption (memory/compute/power specifics)
- Strengthen transfer learning fine-tuning cost caveat
- Strengthen on-demand execution stateful workflow assumption

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
russelltrow and others added 2 commits June 16, 2026 12:39
Replace 'Enterprise Architect' with 'Solution Architect' in three AI
patterns to match the personas defined at
patterns.greensoftware.foundation/personas/

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Split the originally scoped Pattern 4 into two focused patterns per
Naveen Balani's approval:

- 4A: Select efficient ML frameworks and inference runtimes (Development)
  Covers framework/runtime selection criteria, inference-optimised runtimes,
  hardware-specific optimisations, and benchmarking guidance.

- 4B: Optimize agent orchestration to reduce unnecessary model calls (Development)
  Covers caching, conditional logic, batching, early termination, and
  workflow profiling for agentic AI systems.

Both patterns follow the full GSF template including Cost Impact and
description front matter fields.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@russelltrow russelltrow changed the title feat: add 7 AI sustainability patterns to the GSF catalogue feat: add 9 AI sustainability patterns to the GSF catalogue Jun 16, 2026
russelltrow and others added 3 commits June 16, 2026 12:52
All other patterns in the repo use empty tags fields. Comma-separated
string values are not valid YAML arrays and caused a ValidationError
on deploy.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
EOF
)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Five redirects pointed to old pattern paths that no longer exist:
- compress-ml-models-for-inference → right-sized-energy-efficient-ai-models
- energy-efficent-ai-edge → run-ai-models-edge
- efficent-format-for-model-training → optimize-data-storage-ai-training
- right-hardware-type → efficient-hardware-ai-workloads
- leverage-sustainable-regions → carbon-aware-ai-scheduling

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@russelltrow

Copy link
Copy Markdown
Member Author

@LiyaMath @franziska-warncke @navveenb here are the new AI patterns on the staging website:

https://russelltrow.github.io/gsf-patterns/personas/ai-ml-engineer/

@russelltrow russelltrow changed the title feat: add 9 AI sustainability patterns to the GSF catalogue Add 9 new AI sustainability patterns to the catalogue Jun 16, 2026
@russelltrow russelltrow changed the title Add 9 new AI sustainability patterns to the catalogue Add 9 new Green AI patterns to the catalogue Jun 16, 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