Add 9 new Green AI patterns to the catalogue#407
Open
russelltrow wants to merge 18 commits into
Open
Conversation
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>
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>
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>
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/ |
6 tasks
13 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
right-sized-energy-efficient-ai-models.md— Select and optimize AI models appropriately sized for the task to reduce compute, memory, and energy consumption during training and inference.data-handling/optimize-data-storage-ai-training.md— Use efficient storage formats, compression, and indexing strategies for AI datasets and embeddings to reduce storage footprint, data transfer, and retrieval compute.pre-trained-transfer-learning.md— Fine-tune existing pre-trained models instead of training from scratch to dramatically reduce the compute, energy, and time required for model development.select-efficient-ml-frameworks-inference-runtimes.md— Choose ML frameworks and inference runtimes that best match your hardware and workload to reduce compute overhead and improve energy efficiency across training and production inference.optimize-agent-orchestration-reduce-model-calls.md— Design agentic AI workflows to minimise redundant model invocations and unnecessary compute through caching, conditional logic, and efficient orchestration patterns.Architecture
system-topology/run-ai-models-edge.md— Deploy AI inference on edge devices or local infrastructure to reduce data transfer, network energy use, and reliance on centralised cloud compute.system-topology/efficient-hardware-ai-workloads.md— Match AI workloads to the most energy-efficient hardware accelerator or instance type to improve utilisation and reduce energy consumption per inference or training run.system-topology/on-demand-execution-ai-agent-workloads.md— Trigger AI and agent workloads only when needed using serverless or event-driven platforms to eliminate idle compute and reduce unnecessary energy consumption.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 readingAll patterns include a
descriptionfield 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
🤖 Generated with Claude Code