byarielm.fyi
+13
CLAUDE.md
+13
CLAUDE.md
···
141
142
### Git History & Deployment
143
144
+
**CRITICAL: Include decision graph in code commits**
145
+
146
+
Always run `deciduous sync` BEFORE committing code changes, then include the graph updates in the same commit:
147
+
148
+
```bash
149
+
# After making code changes and adding decision nodes:
150
+
deciduous sync # Export graph
151
+
git add src/your-file.ts docs/ # Stage code + graph
152
+
git commit -m "your change" # Single commit with both
153
+
```
154
+
155
+
**DO NOT create separate commits for graph updates.** The decision graph is part of the code history and should be committed together.
156
+
157
```bash
158
# Export graph AND git history for web viewer
159
deciduous sync
+4
-4
docs/git-history.json
+4
-4
docs/git-history.json
···
16
"files_changed": 1
17
},
18
{
19
-
"hash": "6f618f32c42d1e2cfa13c480b2d396c82496eb6c",
20
-
"short_hash": "6f618f3",
21
"author": "Ariel M. Lighty",
22
-
"date": "2025-12-24T16:38:37-05:00",
23
-
"message": "add @ symbol and profile pic to login input\n\nCreated HandleInput component:\n- Shows @ symbol by default\n- Replaces @ with profile pic when handle selected from typeahead\n- Extracts avatar from typeahead data-avatar or actor-select event\n- Clears avatar when input is cleared",
24
"files_changed": 2
25
},
26
{
···
16
"files_changed": 1
17
},
18
{
19
+
"hash": "0411d34fc6418f1b887bbec2470cee9fe7e2d98b",
20
+
"short_hash": "0411d34",
21
"author": "Ariel M. Lighty",
22
+
"date": "2025-12-24T16:53:27-05:00",
23
+
"message": "add rotating platform-agnostic placeholder examples\n\nCreated useRotatingPlaceholder hook:\n- Rotates through 4 platform examples every 3 seconds\n- .bsky.social, .blacksky.app, .tgnl.sh, .com\n- Demonstrates platform flexibility without overwhelming users",
24
"files_changed": 2
25
},
26
{
+22
docs/graph-data.json
+22
docs/graph-data.json
···
1990
"created_at": "2025-12-24T19:39:04.481280600-05:00",
1991
"updated_at": "2025-12-24T19:39:04.481280600-05:00",
1992
"metadata_json": "{\"branch\":\"master\",\"commit\":\"f79a669\",\"confidence\":100}"
1993
}
1994
],
1995
"edges": [
···
3928
"weight": 1.0,
3929
"rationale": "Committed to repository",
3930
"created_at": "2025-12-24T19:39:06.240788400-05:00"
3931
}
3932
]
3933
}
···
1990
"created_at": "2025-12-24T19:39:04.481280600-05:00",
1991
"updated_at": "2025-12-24T19:39:04.481280600-05:00",
1992
"metadata_json": "{\"branch\":\"master\",\"commit\":\"f79a669\",\"confidence\":100}"
1993
+
},
1994
+
{
1995
+
"id": 182,
1996
+
"change_id": "afd62144-3edc-479e-bc6e-7bb28de124e9",
1997
+
"node_type": "observation",
1998
+
"title": "Updated CLAUDE.md to document workflow: run deciduous sync before commits, stage graph updates with code changes. Decision graph is part of code history.",
1999
+
"description": null,
2000
+
"status": "pending",
2001
+
"created_at": "2025-12-24T19:43:00.524530200-05:00",
2002
+
"updated_at": "2025-12-24T19:43:00.524530200-05:00",
2003
+
"metadata_json": "{\"branch\":\"master\",\"confidence\":100}"
2004
}
2005
],
2006
"edges": [
···
3939
"weight": 1.0,
3940
"rationale": "Committed to repository",
3941
"created_at": "2025-12-24T19:39:06.240788400-05:00"
3942
+
},
3943
+
{
3944
+
"id": 177,
3945
+
"from_node_id": 176,
3946
+
"to_node_id": 182,
3947
+
"from_change_id": "85d33a42-5cbc-44b8-8e97-afd3edb1eeda",
3948
+
"to_change_id": "afd62144-3edc-479e-bc6e-7bb28de124e9",
3949
+
"edge_type": "leads_to",
3950
+
"weight": 1.0,
3951
+
"rationale": "Documentation update based on user feedback",
3952
+
"created_at": "2025-12-24T19:43:02.196469100-05:00"
3953
}
3954
]
3955
}