1---
2name: agents-module
3description: Automation scripts and agent helpers for the Digital Brain. Use these scripts for recurring tasks, summaries, and maintenance.
4---
5 
6# Agent Automation
7 
8Scripts and workflows that help maintain and leverage your Digital Brain.
9 
10## Available Scripts
11 
12| Script | Purpose | Frequency |
13|--------|---------|-----------|
14| `weekly_review.py` | Generate weekly review from data | Weekly |
15| `content_ideas.py` | Generate content ideas from knowledge | On-demand |
16| `stale_contacts.py` | Find contacts needing outreach | Weekly |
17| `metrics_snapshot.py` | Compile metrics for tracking | Weekly |
18| `idea_to_draft.py` | Expand an idea into a draft | On-demand |
19 
20## How to Use
21 
22Scripts are in `agents/scripts/`. They work with your Digital Brain data and can be run by the agent when needed.
23 
24### Running Scripts
25```bash
26# Agent can execute scripts directly
27python agents/scripts/weekly_review.py
28 
29# Or with arguments
30python agents/scripts/content_ideas.py --pillar "ai_agents" --count 5
31```
32 
33### Script Outputs
34Scripts output to stdout in a format the agent can process. They may also write to files when appropriate (e.g., generating a review document).
35 
36## Agent Instructions
37 
38<instructions>
39When using automation scripts:
40 
411. **Weekly review**: Run every Sunday, outputs review template with data filled in
422. **Content ideas**: Use when user asks for ideas, leverages knowledge base
433. **Stale contacts**: Run weekly, surfaces relationships needing attention
444. **Metrics snapshot**: Run weekly to append to metrics.jsonl
455. **Idea to draft**: Use when user wants to develop a specific idea
46 
47Scripts read from Digital Brain files and output actionable results.
48</instructions>
49 
50## Workflow Automations
51 
52### Sunday Weekly Review
53```
541. Run metrics_snapshot.py to update metrics.jsonl
552. Run stale_contacts.py to identify outreach needs
563. Run weekly_review.py to generate review document
574. Present summary to user
58```
59 
60### Content Ideation Session
61```
621. Read recent entries from knowledge/bookmarks.jsonl
632. Check content/ideas.jsonl for undeveloped ideas
643. Run content_ideas.py for fresh suggestions
654. Cross-reference with content calendar
66```
67 
68### Pre-Meeting Prep
69```
701. Look up contact in network/contacts.jsonl
712. Pull recent interactions from network/interactions.jsonl
723. Check any pending todos involving them
734. Generate brief with context
74```
75 
76## Custom Script Development
77 
78To add new scripts:
791. Create Python file in `agents/scripts/`
802. Follow existing patterns (read JSONL, output structured data)
813. Document in this file
824. Test with sample data
83