add-lab-results

name	add-lab-results
description	Process new lab results, body composition scans, or medical data. Triggers on "new labs", "lab results", "blood work", "InBody", "DEXA", "test results", or when user shares medical results.

Add Lab / Medical Results

Structured processing of new medical data with automatic updates to all relevant files.

Workflow

digraph lab {
  "Load context" -> "Get data from user";
  "Get data from user" -> "Create .md file";
  "Create .md file" -> "Update medical README";
  "Update medical README" -> "Update relevant domain";
  "Update relevant domain" -> "Update me.md";
  "Update me.md" -> "Find anomalies";
  "Find anomalies" -> "Watchlist check";
}

1. Load Context

File	Why
data/medical/README.md	Existing data overview, formats
Relevant domain README	Previous values for comparison
docs/context/me.md	Current baselines
docs/context/watchlist.md	Expected tests

2. Get Data

If user sent a photo/PDF:

• Read and extract all values
• Verify reference ranges

If user describes verbally:

• Ask for all values systematically
• Confirm you have complete data

ALWAYS determine:

• Date of test/measurement
• Provider (lab name, clinic)
• Context (fasting? morning? weight at time? stress level?)

3. Create File

Lab tests:

data/medical/lab-tests/YYYY-MM-DD-type-provider.md

Body composition:

data/medical/body-comp/YYYY-MM-DD-method.md

Medical records:

data/medical/records/YYYY-MM-DD-type-provider.md

Use consistent format matching existing files in data/medical/.

4. Update Medical README

Add new file to the appropriate table in data/medical/README.md:

• Lab Tests → add to overview
• Body Comp → add to overview + update Quick Reference
• Records → add to overview

If new diagnoses → add to Official Diagnoses section.

5. Update Domain

Lab tests → relevant domain(s):

• Update data timeline
• Compare with previous values
• Highlight changes (better/worse)

Body comp → body composition domain (if exists):

• Update Current Status
• Compare segmental analysis with previous
• Weight/BF%/muscle trend

6. Update me.md

Update baselines in docs/context/me.md:

• Weight, BF%, muscle mass (if body comp)
• Relevant lab values (if changed)
• Date of last measurement

7. Find Anomalies

Required — compare with previous results:

Type	What to Look For
Out of range	Values outside reference ranges
Trend change	Something changed significantly vs last time
Expected effect	Did weight loss / stack change affect markers?
New findings	Something we didn't have before
Artifacts	Could stress, illness, or timing explain an odd result?

If anomaly found → tell the user and suggest what to do.

8. Watchlist Check

• Check docs/context/watchlist.md — was this test on the list?
• If yes → check it off
• If results suggest new tests → add to watchlist
• If an experiment was waiting for these results → update experiment

Output

At the end, summarize:

1. What was added (new file)
2. Key values and comparison with previous
3. Anomalies / red flags
4. Which files were updated
5. Recommendations (follow-up tests, protocol changes)

If user provided an argument

/add-lab-results → ask what type of data and start