feat: GitHub Actions workflow for automated weekly brain updates

[Hrithik-Gavankar]

Summary

Provide a GitHub Actions workflow that automatically runs engineer-brain update on a schedule (weekly/monthly), commits the updated BRAIN.md, and optionally posts a summary.

Motivation

• Engineers forget to run update regularly
• Automated updates keep BRAIN.md fresh without manual intervention
• CI-driven updates ensure consistency

Proposed Implementation

# .github/workflows/brain-update.yml
name: Weekly Brain Update
on:
  schedule:
    - cron: '0 9 * * 1'  # Every Monday at 9 AM
  workflow_dispatch:

jobs:
  update:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run brain scanner
        run: bash .engineer-brain/scripts/scan.sh . 7 --json > scan-output.json
      - name: Update BRAIN.md
        run: # script to merge scan data into BRAIN.md
      - name: Commit changes
        run: |
          git config user.name "engineer-brain[bot]"
          git config user.email "bot@engineer-brain"
          git add .engineer-brain/BRAIN.md
          git diff --cached --quiet || git commit -m "chore: weekly brain update"
          git push

Features

• Reusable GitHub Action (uses: engineer-brain/update-action@v1)
• Configurable schedule
• PR mode (open a PR instead of direct commit)
• Summary comment on PR with diff highlights
• Slack notification on update completion
• Support for monorepo (scan specific directories)