
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:
- Gathers your team's weekly commits from GitHub.
- Uses Amazon Bedrock (Amazon Nova model) to transmute technical achievements into a thrilling 3-paragraph high-fantasy saga.
- 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
- 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.
- 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.
- 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
- GitHub Repository: Β https://github.com/MdIbuA/GitBardΒ
- AWS Infrastructure: Serverless AWS SAM & CloudFormation (Β
template.yamlΒ)
- Automated Deployer: Python Boto3 Script (Β
deploy.pyΒ)
Enjoyed reading this content? Let the author know!
Your likes, comments, shares, and saves help creators reach more builders.
Loading recommendations
Loading article