System Overview
SimpleStruct uses a suite of GitHub Actions workflows that work together to automate project management, stakeholder communication, and content updates. The result: you just write code, and everything else happens automatically.
🎯 The Simple Version: Robots watch your work, write summaries, send emails to your team, update documentation, and keep everyone informed — all without you lifting a finger after you commit your code.
The Automation Workflows
📧
Weekly Update (Every Monday)
Automatically generates and emails a professional project status report every Monday at 6 AM PST.
How it works:
- Pulls all commits from the past 7 days
- Reads current project milestones
- Sends commits + milestones to ChatGPT for analysis
- AI generates Timeline/Scope/Risk assessment
- AI suggests next week's action items
- Creates markdown entry in weekly updates page
- Sends styled HTML email with logo and signature
Trigger: cron: '0 14 * * 1' (Monday 2 PM UTC / 6 AM PST)
📜
Changelog Generator (Every Commit)
Maintains a complete, organized commit history grouped by month and year — automatically updated after every push.
How it works:
- Triggered on every push to main branch
- Reads entire git history
- Groups commits by month/year into tables
- Shows latest 10 commits with full details
- Updates CHANGELOG.md automatically
- Publishes to GitHub Pages
Trigger: push: branches: [main]
📰
News Feed Generator (Daily)
Fetches industry news and updates the news page with fresh content every day.
How it works:
- Runs daily on schedule
- Fetches RSS feeds from industry sources
- Parses and formats news items
- Updates news-data.js with fresh content
- Website dynamically displays latest news
Trigger: schedule (daily)
📅
Events Calendar (Daily)
Keeps the events page updated with upcoming industry conferences, webinars, and meetups.
How it works:
- Runs daily on schedule
- Fetches event data from configured sources
- Filters for relevant upcoming events
- Updates events-data.js
- Events page shows fresh content automatically
Trigger: schedule (daily)
📚
Documentation Publisher (Every Commit)
Builds and publishes the Sphinx documentation site to GitHub Pages after every change.
How it works:
- Triggered on push to main branch
- Installs Sphinx and dependencies
- Builds HTML from markdown/RST files
- Deploys to GitHub Pages
- Live at constructivision.github.io
Trigger: push: branches: [main]
The Big Picture
You commit code → Everything else is automated:
- ✅ Website deploys in 2-3 minutes
- ✅ Documentation updates instantly
- ✅ Changelog records your work
- ✅ Weekly emails keep stakeholders informed
- ✅ News and events stay fresh
- ✅ AI analyzes progress against milestones
This is what "infrastructure as code" looks like when done right — the robots handle the busywork so you can focus on building.
Technology Stack
Automation Engine
GitHub Actions with scheduled and event triggers
AI Integration
OpenAI GPT-4o-mini for content analysis
Email Delivery
Gmail SMTP with App Passwords
Documentation
Sphinx + MyST for markdown support
Content Feeds
RSS parsing for news and events
Version Control
Git with automatic commits from Actions
Cost & Efficiency
- GitHub Actions: Free for public repos (2,000 minutes/month for private)
- OpenAI API: ~$0.01-0.05 per weekly update (GPT-4o-mini)
- Human Time Saved: 2-4 hours/week on status reports and documentation
- Zero Manual Publishing: Everything auto-deploys on commit
For More Information
See the GitHub Repository for:
- Weekly update workflow (
.github/workflows/weekly-update.yml)
- Changelog generator (
.github/workflows/update-changelog.yml)
- News/Events feeds (
.github/workflows/news-*.yml, events-*.yml)
- Documentation builder (
.github/workflows/pages.yml)
← View Website Deployment Pipeline
SimpleStruct - Powered by ConstructiVision | Fully Automated Project Management