Document the three-layer model, add railiance-rhythm executor install, and point playbooks at rein-aharness fi-research-brief instead of local crontab.
4.1 KiB
Daily research brief — playbook
Audience: operator or agent executing target_repo: freedom-intelligence
Template: briefs/_template.md
Baseline memory: research/2026-07-24-baseline-field-survey.md
Sources: docs/sources-allowlist.md
Purpose
Produce one curated brief per active day covering axes A–D when there is signal. Briefs are deltas from the baseline survey and prior briefs — not full resurveys.
Idempotence
| Rule | Detail |
|---|---|
| One brief per date | Path briefs/YYYY/MM/YYYY-MM-DD.md |
| Calendar | Prefer Europe/Berlin date in front matter |
| Skip empty days | Either omit file or write *No material delta.* in Headline deltas |
| Automation due bit | Cleared only by State Hub event fi_daily_brief (below) |
Manual procedure
-
Orient
- Read last 1–2 briefs if any; skim baseline § executive snapshot if first week
git pullon freedom-intelligence
-
Scan (
docs/sources-allowlist.md) — 30–60 minutes cap- Capture only items that change capability, cost, access, or operability
-
Draft
mkdir -p briefs/$(date +%Y/%m) cp briefs/_template.md briefs/$(date +%Y/%m)/$(date +%Y-%m-%d).md- Fill front matter (
status: finalwhen done) - Leave empty sections as
*(none)* - Cite primary URLs
- Fill front matter (
-
Collection candidates
- Use inventory field names; set priority
- If nominating: add or update
inventory/catalog/{id}.yamlwithstatus: candidateandcollection.brief_refs
-
Lab implications
- Link open workplans (
FI-WP-*) only when action is real
- Link open workplans (
-
Commit (operator policy) — brief + any catalog YAML
-
Completion evidence (required for activity-core rhythm)
Post State Hub progress (HTTP or MCP), shape:
event_type: fi_daily_brief author: <agent-or-operator> summary: "FI daily brief YYYY-MM-DD" detail: repo: freedom-intelligence date: "YYYY-MM-DD" path: "briefs/YYYY/MM/YYYY-MM-DD.md" collection_candidates: 0Workstation API often
http://127.0.0.1:8000; remote tunnel ports per Custodian docs. Seedocs/state-hub-delivery.md.
Automation consumer (activity-core design)
Organizer: activity-core (when / what / where) — not workstation cron.
Executor: rein-aharness on railiance01 (fi-research-brief).
Org playbook: activity-core/docs/recurring-automations-playbook.md.
When activity-core emits activity_task_spawn with
target_repo: freedom-intelligence and labels including research-brief:
- Railiance host timer (or manual) runs
rein-aharness fi-research-brief --target-repo ~/freedom-intelligence - llm-connect drafts the brief; harness commits and posts
fi_daily_brief - Idempotency: one brief file per date; resolver clears
dueon completion event
Do not install Claude Code / Codex on railiance01 for this rhythm.
| Piece | Location |
|---|---|
| Definition | activity-definitions/fi-daily-research-brief.md |
| Ops | docs/recurrence-ops.md |
| Executor install | scripts/railiance-rhythm/install-on-railiance.sh |
| Workplan | FI-WP-0002 (finished) |
| Resolver | fi_brief_status in activity-core |
Ops: load this repo’s definitions
# Dev
export ACTIVITY_DEFINITION_DIRS=.../freedom-intelligence
make -C ~/activity-core sync-activity-definitions
# Production: ConfigMap actcore-external-activity-definitions
# then POST /admin/sync?definitions=true&schedules=true
Quality bar
| Check | Pass |
|---|---|
| Signal | No filler paragraphs |
| Sources | At least one primary link per non-empty axis row |
| Honesty | Benchmarks marked directional; prices “verify before budget” |
| Collection | License noted for any candidate |
| Length | Prefer one screen to three; deep dives go under research/ |
First daily after baseline
The baseline survey (2026-07-24) already covers the field. The first daily
should only list changes after that document’s research window. If nothing
moved, a short no-delta brief still completes the rhythm and posts
fi_daily_brief.