1# File Format Reference
2 
3Detailed specifications for each file format used in Digital Brain.
4 
5---
6 
7## JSONL Files
8 
9### Schema Convention
10 
11Every JSONL file starts with a schema definition line:
12 
13```json
14{"_schema": "schema_name", "_version": "1.0", "_description": "Purpose of this file"}
15```
16 
17This line is skipped during data processing but documents the expected structure.
18 
19### Common Fields
20 
21All data entries should include:
22 
23```json
24{
25  "id": "type_YYYYMMDD_HHMMSS",  // Unique identifier
26  "created": "ISO8601",           // Creation timestamp
27  "updated": "ISO8601"            // Last modification (optional)
28}
29```
30 
31### ideas.jsonl
32 
33```json
34{
35  "id": "idea_20241229_143022",
36  "created": "2024-12-29T14:30:22Z",
37  "idea": "Content of the idea",
38  "source": "observation|conversation|reading|shower_thought",
39  "pillar": "content_pillar_name",
40  "status": "raw|developing|ready|published|archived",
41  "priority": "high|medium|low",
42  "notes": "Additional context",
43  "tags": ["tag1", "tag2"]
44}
45```
46 
47### posts.jsonl
48 
49```json
50{
51  "id": "post_20241229_160000",
52  "published": "2024-12-29T16:00:00Z",
53  "platform": "twitter|linkedin|newsletter|blog|youtube",
54  "type": "post|thread|article|video|podcast",
55  "content": "Full content or summary",
56  "url": "https://...",
57  "pillar": "content_pillar_name",
58  "metrics": {
59    "impressions": 0,
60    "likes": 0,
61    "comments": 0,
62    "reposts": 0,
63    "saves": 0
64  },
65  "metrics_updated": "2024-12-29T20:00:00Z",
66  "notes": "What worked/didn't",
67  "tags": ["tag1", "tag2"]
68}
69```
70 
71### contacts.jsonl
72 
73```json
74{
75  "id": "contact_johndoe",
76  "created": "2024-01-15T00:00:00Z",
77  "updated": "2024-12-29T00:00:00Z",
78  "name": "John Doe",
79  "handle": "@johndoe",
80  "email": "[email protected]",
81  "company": "Acme Inc",
82  "role": "CEO",
83  "location": "San Francisco, USA",
84  "circle": "inner|active|network|dormant",
85  "how_met": "Met at conference",
86  "relationship": "friend|mentor|peer|collaborator|investor|customer",
87  "topics": ["ai", "startups"],
88  "can_help_with": ["intros to VCs"],
89  "you_can_help_with": ["technical advice"],
90  "notes": "Personal context",
91  "last_contact": "2024-12-15T00:00:00Z",
92  "links": {
93    "twitter": "https://twitter.com/johndoe",
94    "linkedin": "https://linkedin.com/in/johndoe",
95    "website": "https://johndoe.com"
96  }
97}
98```
99 
100### interactions.jsonl
101 
102```json
103{
104  "id": "int_20241229_100000",
105  "date": "2024-12-29T10:00:00Z",
106  "contact_id": "contact_johndoe",
107  "type": "call|coffee|dm|email|event|collab",
108  "context": "Discussed partnership opportunity",
109  "key_points": ["Point 1", "Point 2"],
110  "follow_ups": ["Send proposal", "Intro to Sarah"],
111  "sentiment": "positive|neutral|needs_attention"
112}
113```
114 
115### bookmarks.jsonl
116 
117```json
118{
119  "id": "bm_20241229_120000",
120  "saved_at": "2024-12-29T12:00:00Z",
121  "url": "https://example.com/article",
122  "title": "Article Title",
123  "source": "article|video|podcast|tool|tweet|paper",
124  "category": "ai_agents|building|growth|productivity|leadership|industry|personal",
125  "summary": "1-2 sentence summary",
126  "key_insights": ["Insight 1", "Insight 2"],
127  "status": "unread|read|reviewed|archived",
128  "rating": 1-5,
129  "tags": ["tag1", "tag2"]
130}
131```
132 
133### meetings.jsonl
134 
135```json
136{
137  "id": "mtg_20241229_140000",
138  "date": "2024-12-29T14:00:00Z",
139  "title": "Meeting Title",
140  "type": "1on1|team|external|interview|pitch|advisory",
141  "attendees": ["John Doe", "Jane Smith"],
142  "duration_mins": 30,
143  "agenda": ["Topic 1", "Topic 2"],
144  "notes": "Discussion summary",
145  "decisions": ["Decision made"],
146  "action_items": [
147    {"task": "Task description", "owner": "John", "due": "2024-12-31"}
148  ],
149  "follow_up": "Next steps"
150}
151```
152 
153### metrics.jsonl
154 
155```json
156{
157  "id": "metrics_20241229",
158  "week_of": "2024-12-23",
159  "recorded_at": "2024-12-29T00:00:00Z",
160  "audience": {
161    "twitter_followers": 5000,
162    "newsletter_subscribers": 1200,
163    "linkedin_connections": 3000,
164    "youtube_subscribers": 500
165  },
166  "engagement": {
167    "avg_impressions": 10000,
168    "avg_engagement_rate": 0.05,
169    "newsletter_open_rate": 0.45
170  },
171  "content": {
172    "posts_published": 7,
173    "threads_published": 2,
174    "newsletters_sent": 1
175  },
176  "business": {
177    "revenue": 0,
178    "mrr": 0,
179    "customers": 0,
180    "leads": 5
181  },
182  "personal": {
183    "deep_work_hours": 25,
184    "exercise_sessions": 4,
185    "books_read": 0.5
186  },
187  "notes": "Strong week for content"
188}
189```
190 
191---
192 
193## YAML Files
194 
195### values.yaml
196 
197```yaml
198core_values:
199  - name: "Value Name"
200    description: "What it means"
201    in_practice: "How it shows up"
202 
203beliefs:
204  - "Belief statement"
205 
206contrarian_views:
207  - view: "The view"
208    reasoning: "Why you hold it"
209 
210non_negotiables:
211  - "Line you won't cross"
212 
213principles:
214  content_creation:
215    - "Principle"
216  business:
217    - "Principle"
218```
219 
220### goals.yaml
221 
222```yaml
223current_period:
224  quarter: "Q1 2025"
225  theme: "Growth focus"
226 
227objectives:
228  - objective: "Objective statement"
229    why: "Why it matters"
230    key_results:
231      - description: "KR description"
232        target: 100
233        current: 25
234        unit: "followers"
235        status: "on_track|at_risk|behind|completed"
236 
237north_star:
238  metric: "The one metric"
239  current: 1000
240  target: 10000
241  why: "Why this matters most"
242```
243 
244### learning.yaml
245 
246```yaml
247current_focus:
248  skill: "Skill name"
249  why: "Why learning this"
250  target_level: "Target proficiency"
251  deadline: "2025-03-31"
252 
253skills:
254  - name: "Skill name"
255    category: "technical|creative|business|personal"
256    current_level: "beginner|intermediate|advanced|expert"
257    target_level: "Target"
258    status: "learning|practicing|maintaining"
259    resources:
260      - type: "course|book|tutorial|project"
261        title: "Resource name"
262        url: "https://..."
263        status: "not_started|in_progress|completed"
264    milestones:
265      - "Milestone description"
266    last_practiced: "2024-12-29"
267```
268 
269### circles.yaml
270 
271```yaml
272circles:
273  inner:
274    description: "Close relationships"
275    touchpoint_frequency: "weekly"
276    members:
277      - "Name - context"
278 
279  active:
280    description: "Current collaborators"
281    touchpoint_frequency: "bi-weekly"
282    members:
283      - "Name - context"
284 
285groups:
286  founders:
287    description: "Fellow founders"
288    members:
289      - "Name"
290 
291goals:
292  this_quarter:
293    - "Relationship goal"
294```
295 
296---
297 
298## Markdown Files
299 
300### Structure Convention
301 
302All markdown files follow this structure:
303 
304```markdown
305# Title
306 
307Brief description.
308 
309---
310 
311## Section 1
312 
313Content...
314 
315---
316 
317## Section 2
318 
319Content...
320 
321---
322 
323*Last updated: [DATE]*
324```
325 
326### Placeholder Convention
327 
328Use `[PLACEHOLDER: description]` for user-fillable fields:
329 
330```markdown
331### Your Story
332```
333[PLACEHOLDER: Write your founder journey here]
334```
335```
336 
337---
338 
339## XML Files
340 
341### Prompt Template Structure
342 
343```xml
344<?xml version="1.0" encoding="UTF-8"?>
345<prompt name="prompt-name" version="1.0">
346  <description>
347    What this prompt does
348  </description>
349 
350  <instructions>
351    <context>
352      Background for the task
353    </context>
354 
355    <guidelines>
356      Rules to follow
357    </guidelines>
358 
359    <output_requirements>
360      Expected output format
361    </output_requirements>
362  </instructions>
363 
364  <examples>
365    Input/output examples
366  </examples>
367</prompt>
368```
369 
370---
371 
372## ID Generation
373 
374### Convention
375 
376`{type}_{YYYYMMDD}_{HHMMSS}` or `{type}_{unique_slug}`
377 
378Examples:
379- `idea_20241229_143022`
380- `contact_johndoe`
381- `post_20241229_160000`
382- `bm_20241229_120000`
383 
384### Uniqueness
385 
386IDs must be unique within their file. Timestamp-based IDs ensure uniqueness for time-series data.
387