Automated Product & Project Management

How GitHub Actions power a fully automated system that manages itself while you focus on building.

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.

🧒 Simple Explanation: Every Monday morning, a robot looks at all the work you did last week, writes a report about it, and emails it to your team. It's like having a personal assistant who never forgets to send the weekly update!

How it works:
  1. Pulls all commits from the past 7 days
  2. Reads current project milestones
  3. Sends commits + milestones to ChatGPT for analysis
  4. AI generates Timeline/Scope/Risk assessment
  5. AI suggests next week's action items
  6. Creates markdown entry in weekly updates page
  7. 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.

🧒 Simple Explanation: Every time you save your work, a robot writes it down in a big history book. The book is organized by month, so you can always look back and see what happened in January, February, or any time!

How it works:
  1. Triggered on every push to main branch
  2. Reads entire git history
  3. Groups commits by month/year into tables
  4. Shows latest 10 commits with full details
  5. Updates CHANGELOG.md automatically
  6. 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.

🧒 Simple Explanation: A robot reads newspapers about construction and engineering every day, picks out the interesting stories, and puts them on your website. Your visitors always see fresh news without you doing anything!

How it works:
  1. Runs daily on schedule
  2. Fetches RSS feeds from industry sources
  3. Parses and formats news items
  4. Updates news-data.js with fresh content
  5. Website dynamically displays latest news

Trigger: schedule (daily)

📅 Events Calendar (Daily)

Keeps the events page updated with upcoming industry conferences, webinars, and meetups.

🧒 Simple Explanation: A robot checks calendars every day to find cool events like conferences and classes. It adds them to your website's calendar so visitors always know what's coming up!

How it works:
  1. Runs daily on schedule
  2. Fetches event data from configured sources
  3. Filters for relevant upcoming events
  4. Updates events-data.js
  5. 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.

🧒 Simple Explanation: When you update the instruction manual, a robot automatically turns it into a beautiful website that anyone can read. No need to publish anything yourself!

How it works:
  1. Triggered on push to main branch
  2. Installs Sphinx and dependencies
  3. Builds HTML from markdown/RST files
  4. Deploys to GitHub Pages
  5. Live at constructivision.github.io

Trigger: push: branches: [main]

The Big Picture

You commit code → Everything else is automated:

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

For More Information

See the GitHub Repository for:

← View Website Deployment Pipeline


SimpleStruct - Powered by ConstructiVision | Fully Automated Project Management