AWS Builder Center
Weekend Creative Agent Challenge: The Git Bard βš”οΈπŸ“œ

Weekend Creative Agent Challenge: The Git Bard βš”οΈπŸ“œ

The Git Bard is an autonomous, always-on serverless AI agent built for the AWS Free Tier. Every Friday afternoon, it fetches your weekly GitHub commits, uses Amazon Bedrock's Nova model to transmute technical bug fixes and pull requests into an epic high-fantasy saga, and delivers a stylized chronicle email straight to your inbox via Amazon SES.

βš”οΈ The Git Bard: Transforming Weekly Git Commits into Epic Fantasy Chronicles with Amazon Bedrock Nova & AWS Serverless

Author: Mohamed Ibrahim A (Β @MdIbuAΒ ) Repository: Β https://github.com/MdIbuA/GitBardΒ  Tags: Β #AgentsΒ , Β #ServerlessΒ , Β #AmazonBedrockΒ , Β #GenAIΒ , Β #AWSFreeTierΒ , Β #PythonΒ , Β #LambdaΒ 

ο»Ώ

🌟 Vision & What It Does

The Problem: Dry, Sterile Engineering Recaps

At the end of every work week, software developers across the globe face the same tedious ritual: reviewing pull requests, scrolling through commit histories, and drafting standup summaries. While these commits represent days of intense problem solving, late-night triumphs over insidious bugs, and bold architectural changes, the records look like sterile machinery:
- fix: resolve race condition in token refresh handler
- refactor: split monolith database module into micro-clients
- feat: add pagination and sorting to /api/v2/artifacts
- test: increase unit test coverage to 92%
The human creativity, grit, and triumph behind software engineering are lost in translation.

The Solution: An Always-On Fantasy Chronicler

The Git Bard is an autonomous, always-on AI agent that celebrates software development as an epic adventure. Waking up autonomously every Friday afternoon, the Bard:
  1. Gathers your team's weekly commits from GitHub.
  1. Uses Amazon Bedrock (Amazon Nova model) to transmute technical achievements into a thrilling 3-paragraph high-fantasy saga.
  1. Renders the tale into a medieval parchment-styled HTML email and delivers it straight to your inbox using Amazon SES.
With The Git Bard, resolving memory leaks becomes "slaying venomous dungeon serpents", refactoring legacy code becomes "cleansing corrupted ancient ley-lines", and shipping a new endpoint becomes "forging a mythic arcane portal".

ο»Ώ

πŸ›οΈ AWS Services Used & Architecture Overview

The Git Bard is built on a 100% serverless, event-driven architecture designed to operate entirely within the AWS Free Tier.
+-----------------------+
| Amazon EventBridge |
| (Cron: Fridays @ 4PM) |
+-----------+-----------+
|
v
+-----------------------+
| AWS Lambda (Py) |
| "The Git Bard" |
+-----+-----+-----+-----+
| | |
+-------------------------+ | +-------------------------+
| | |
v v v
+-------------------+ +-------------------+ +-------------------+
| GitHub REST API | | Amazon Bedrock | | Amazon SES |
| (Fetch 7-day logs)| | (Nova Micro Model)| | (Deliver Chronicle|
+-------------------+ +-------------------+ | to Inbox) |
+-------------------+

AWS Services Breakdown:

  • AWS Lambda (Python 3.12, ARM64): Houses the core agent brain, orchestrating commit retrieval, Bedrock prompt construction, and email dispatch with sub-second execution times.
  • Amazon EventBridge (Scheduler): Provides the recurring heartbeat, triggering the Lambda function every Friday afternoon via a scheduled cron rule (Β cron(0 16 ? * FRI *)Β ).
  • Amazon Bedrock (Amazon Nova Micro Β amazon.nova-micro-v1:0Β ): Powers the creative reasoning and lore generation using Bedrock's unified Converse API.
  • Amazon Simple Email Service (SES): Formats and delivers high-deliverability HTML emails to developers.
  • AWS CloudFormation / SAM: Manages Infrastructure as Code (IaC) for reproducible deployments.

ο»Ώ

πŸ› οΈ How I Built It: Process, Key Decisions & Challenges

1. Designing the Technical-to-Fantasy Lore Matrix

To ensure the generated stories were grounded in the actual codebase changes rather than generic fantasy tropes, I designed a structured prompt schema:
Git Commit Activity
High-Fantasy Metaphor
Bug Fixes (Β fixΒ )
Slaying bugbears, banishing hexes, exterminating pests
Refactorings (Β refactorΒ )
Purifying corrupted ley-lines, pruning enchanted dark forests
New Features (Β featΒ )
Forging mythic weapons, raising fortress walls, opening portals
Testing & CI/CD (Β testΒ , Β ciΒ )
Inscribing ancient warding shields, erecting barrier enchantments
Documentation (Β docsΒ )
Inscribing sacred spell scrolls in the Grand Realm Archives
# System prompt snippet from src/app.py
prompt = (
"You are the Legendary Realm Bard, chronicling the heroic sagas of software wizards.\n"
"Below is the sacred war scroll of technical commit logs from the past 7 days:\n"
f"{commit_summary}\n\n"
"Instructions:\n"
"1. Transform these technical deeds into an epic 3-paragraph adventure story.\n"
"2. Weave the developer names as heroic guild champions performing these feats.\n"
"3. Structure: Dramatic Chapter Title, The Rising Peril, The Climax of Battle, and The Dawn of Peace."
)

2. Modernizing with the Amazon Bedrock Converse API

One of the key technical decisions was leveraging the Amazon Bedrock Converse API (Β bedrock.converse(...)Β ) with a fallback to Β invoke_modelΒ . This unified interface allows seamless model switching between Amazon Nova Micro, Nova Lite, and Nova Pro without rewriting request payloads or output extraction logic.

3. Overcoming Challenges & Zero-Dependency Deployment

  • Challenge: Multi-environment CLI friction. Installing AWS SAM CLI and configuring credentials on different developer machines can often introduce friction.
  • Solution: In addition to standard Β template.yamlΒ  SAM support, I engineered a zero-dependency deployment script (Β deploy.pyΒ ) using pure Β boto3Β . It zips the package in memory, creates a versioned S3 deployment bucket, and orchestrates CloudFormation stack updates natively.

ο»Ώ

πŸ“¬ Live Verification & Results

During deployment, the email delivery pipeline was verified through Amazon SES:
From: ibrahimabdullah.dev@gmail.com via amazonses.com
To: ibrahimabdullah.dev@gmail.com
Subject: βš”οΈ The Git Bard: Setup Test Successful!
Body: "Greetings Adventurer! Your Amazon SES is verified and ready for The Git Bard."

Sample Output Generated by Amazon Nova Micro:

Chapter XIV: The Cleansing of the Null Woods & The Arcane DeployerThe kingdom of Code was threatened by the creeping shadow of memory corruption along the borderlands. Guild Champion Ibrahim stepped forward, raising the sacred blade of strict type validation to dispel the beasts and restore balance to the runtime realm.Deep within the forge of CloudFormation, great fires roared as the artisans forged the legendary 'Git Bard Deployer', an automated arcane vessel designed to channel the power of Bedrock Nova and EventBridge across the realms without mortal intervention.As twilight descends upon the guild hall, the wards stand unbroken, the test suites shine with divine green light, and the champions rest by the hearth, ready for the quests that await at dawn.

ο»Ώ

πŸ’‘ What I Learned

  1. Autonomous Agents Don't Need Heavyweight Infrastructure: You don't need persistent EC2 servers or container clusters to build powerful AI agents. Serverless primitives like EventBridge and Lambda are the ideal foundation for scheduled autonomous agents.
  1. Amazon Bedrock Nova is Built for Developer Speed: The Nova Micro model provides lightning-fast inference with exceptional storytelling and instruction-following capabilities, all while remaining practically free under standard workloads.
  1. Developer Joy is a Valid Use Case: AI tools often focus strictly on utility and code completion. Creating tools that add delight, storytelling, and humor to the developer experience has a tremendous impact on team morale.

ο»Ώ

πŸ”— Code & Resources

  • AWS Infrastructure: Serverless AWS SAM & CloudFormation (Β template.yamlΒ )
  • Automated Deployer: Python Boto3 Script (Β deploy.pyΒ )
Any opinions in this article are those of the individual author and may not reflect the opinions of AWS.
Enjoyed reading this content? Let the author know!

Your likes, comments, shares, and saves help creators reach more builders.

Loading recommendations

Loading article