bereniketech/aios-cadence

AIOS Cadence

---

1. Detect Cadence Mechanism

| Signal | Mechanism | Priority | |---|---|---| | lib/inngest/ exists in project | Inngest scheduled functions | Highest | | .github/workflows/ exists | GitHub Actions cron workflow | Medium | | Neither present | Claude Code CronCreate | Fallback |

Use the highest-priority mechanism found. If both Inngest and GitHub Actions exist, use Inngest for data tasks and GitHub Actions for repo-level summaries.

---

2. Three Standard AIOS Tasks

A — Daily Stand-Up

Reads context/priorities.md + task source (GitHub Issues / .spec/tasks/ / ClickUp / Notion) → writes context/standup-[date].md. Schedule: Daily 08:00 (project timezone or UTC)

Output format:

# Stand-Up — [date]
## Top 3 focus items
1. [task] — [source]
2. [task] — [source]
3. [task] — [source]
## Blocked
- [anything flagged blocked, or "none"]
## Carry-forward
- [items not completed yesterday, or "none"]

B — Weekly Review

Reads context/priorities.md + decisions/ log → flags priority drift → writes context/weekly-review-[date].md. Schedule: Every Monday 09:00

Output: Status (on-track / at-risk / drifted) for each quarterly goal + one recommendation.

C — Analytics Snapshot

Calls the live analytics connection (GA4, PostHog, Supabase metrics) → writes context/analytics-snapshot.md. Schedule: Every Monday 09:00 (same run as weekly review)

Output: Key metrics + week-over-week delta + one anomaly if detected.

Rule: If the analytics connection is not yet live in connections.md, scaffold the snapshot task but leave the data-fetch step as a TODO comment — do not silently skip the file.

---

3. Scaffold by Mechanism

Inngest

For each task, create lib/inngest/aios-[task].ts:

import { inngest } from "./client";

export const aiosDailyStandup = inngest.createFunction(
  { id: "aios-daily-standup", name: "AIOS Daily Stand-Up" },
  { cron: "0 8 * * *" },
  async ({ step }) => {
    await step.run("read-priorities", async () => {
      // Read context/priorities.md
    });
    await step.run("fetch-tasks", async () => {
      // Fetch from configured task source
    });
    await step.run("write-standup", async () => {
      // Write context/standup-[date].md
    });
  }
);

Add each function to the Inngest serve handler export array. Export from lib/inngest/index.ts if that file exists.

GitHub Actions

Create .github/workflows/aios-weekly.yml:

name: AIOS Weekly Review
on:
  schedule:
    - cron: '0 9 * * 1'
  workflow_dispatch:
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run AIOS weekly review
        run: node scripts/aios-weekly.js
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Also scaffold scripts/aios-weekly.js with the review logic.

CronCreate

Use the CronCreate tool to register each task. Each task reads context/ and writes back to context/.

---

4. Completion Report

Cadence scaffolded — [mechanism].
✓ Daily stand-up    cron: 0 8 * * *
✓ Weekly review     cron: 0 9 * * 1
✓ Analytics snapshot cron: 0 9 * * 1

Files created: [list]

Next: trigger a manual run to verify the first output appears in context/.

Rule: Always trigger a manual run immediately after scaffolding — don't wait for the first scheduled fire to discover a misconfiguration.