Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 13 additions & 11 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,17 +39,19 @@ Index for humans and AI agents. Agents should start at [AGENT_START_HERE.md](./A

### Operations

| Doc | Topic |
| --------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [local-development.md](./operations/local-development.md) | Install, dev server, scripts |
| [environment-variables.md](./operations/environment-variables.md) | Full env reference |
| [database.md](./operations/database.md) | Schema, migrations, seed |
| [deployment.md](./operations/deployment.md) | Vercel, cron, production checks |
| [verification.md](./operations/verification.md) | Typecheck, lint, build, manual checks |
| [ai-workflow.md](./operations/ai-workflow.md) | Pinned and local agent skills, synchronization, CI guards and compatibility pilot |
| [skill-staging-verification.md](./operations/skill-staging-verification.md) | Skill Updates isolation, live approval gates, budgets and rollout sequence |
| [typescript.md](./operations/typescript.md) | Why TypeScript 7 and 6 are both installed |
| [navigation-and-caching.md](./operations/navigation-and-caching.md) | Cache Components, Partial Prefetching, Suspense, and cache policy |
| Doc | Topic |
| ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [local-development.md](./operations/local-development.md) | Install, dev server, scripts |
| [environment-variables.md](./operations/environment-variables.md) | Full env reference |
| [database.md](./operations/database.md) | Schema, migrations, seed |
| [deployment.md](./operations/deployment.md) | Vercel, cron, production checks |
| [verification.md](./operations/verification.md) | Typecheck, lint, build, manual checks |
| [ai-workflow.md](./operations/ai-workflow.md) | Pinned and local agent skills, synchronization, CI guards and compatibility pilot |
| [skill-staging-verification.md](./operations/skill-staging-verification.md) | Skill Updates isolation, live approval gates, budgets and rollout sequence |
| [skill-openrouter-live-evaluation.md](./audits/skill-openrouter-live-evaluation.md) | Phase B live results, report quality and billing limitations |
| [skill-phase-b-benchmark-readiness.md](./audits/skill-phase-b-benchmark-readiness.md) | Phase B semantic/diagnostic hardening and proposed fair model benchmarks |
| [typescript.md](./operations/typescript.md) | Why TypeScript 7 and 6 are both installed |
| [navigation-and-caching.md](./operations/navigation-and-caching.md) | Cache Components, Partial Prefetching, Suspense, and cache policy |

---

Expand Down
293 changes: 293 additions & 0 deletions docs/audits/skill-openrouter-live-evaluation.md

Large diffs are not rendered by default.

127 changes: 127 additions & 0 deletions docs/audits/skill-phase-b-benchmark-readiness.md

Large diffs are not rendered by default.

100 changes: 53 additions & 47 deletions docs/features/agent-skill-updates.md

Large diffs are not rendered by default.

5 changes: 3 additions & 2 deletions docs/operations/deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,15 @@
{
"crons": [
{ "path": "/api/cron/fetch-releases", "schedule": "0 0,12 * * *" },
{ "path": "/api/cron/send-digest", "schedule": "0 14 * * 1" }
{ "path": "/api/cron/send-digest", "schedule": "0 14 * * 1" },
{ "path": "/api/cron/fetch-skill-updates", "schedule": "30 0,12 * * *" }
]
}
```

Release fetch runs at **00:00 and 12:00 UTC** daily; digest emails send **Mondays 14:00 UTC** (after the Monday fetch). Both authenticated with `CRON_SECRET` bearer header. Digest sending also needs `RESEND_API_KEY` + `DIGEST_FROM_EMAIL` (no-ops with a warning otherwise).

Skill Updates scheduling is intentionally absent pending staging verification and separate migration/deployment/cron-enable approvals. Its proposed 00:30/12:30 UTC schedule, exact checks, budgets and recovery sequence are maintained in the [Skill Updates staging runbook](skill-staging-verification.md).
Skill Updates is configured for **00:30 and 12:30 UTC** daily (**07:30 and 19:30 Asia/Ho_Chi_Minh**) using the same cron authentication. D1 initialized ten production baselines without AI requests; the operator separately approved adding this D2 schedule. Vercel registers it only when this configuration is deployed to Production; pushing a task branch alone does not activate it. Verify the effective production registration and subsequent runs using the [Skill Updates staging runbook](skill-staging-verification.md).

Release cron also requires a valid `GITHUB_TOKEN`. Manual `GET /api/cron/github-health`,
protected by the same `CRON_SECRET`, checks it with one read-only GitHub request and no
Expand Down
Loading
Loading