mark64oswaldmark64oswald/healthsim-workspace/.claude/CLAUDE.md

healthsim-workspace

CLAUDE.md9 starsChanged 17 days agoApache-2.0View on GitHub

IMPORTANT: This workspace uses skill files to guide responses. Before attempting web searches, writing code, or improvising: PopulationSim has embedded data files in skills/populationsim/data/. For lookups: Example for county lookup:

In this repository11 other files it gives its agents.
- formatsSkill
- healthsimSkill
- commonSkill
- generationSkill
- healthsimSkill
- membersimSkill
- networksimSkill
- patientsimSkill
- populationsimSkill
- rxmembersimSkill
- trialsimSkill

The file

We split this CLAUDE.md into the rules it gives an agent

4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Use grep to find rows by FIPS code or name
line 27
Very specific:
Use Read to get column headers
line 28
Distinctive:
Skills contain the instructions: - read them before improvising
line 49
Distinctive:
Data is embedded: - no web searches needed for demographics/SDOH
line 50

≈ “Common” is an estimate: at least 1 in 5 of the 26,980 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

CLAUDE.md

HealthSim Workspace Instructions

Skills-First Approach

IMPORTANT: This workspace uses skill files to guide responses. Before attempting web searches, writing code, or improvising:

Read SKILL.md at workspace root for routing guidance
Route to the appropriate product skill based on the request
Follow the skill's documented patterns for data access and response format

Skill Routing

Request Type	Route To
Demographics, SDOH, SVI, ADI, county/tract profiles	`skills/populationsim/SKILL.md`
Patients, clinical data, diagnoses, labs, EMR	`skills/patientsim/SKILL.md`
Claims, members, enrollment, benefits	`skills/membersim/SKILL.md`
Pharmacy, prescriptions, formulary, DUR	`skills/rxmembersim/SKILL.md`
Clinical trials, subjects, CDISC	`skills/trialsim/SKILL.md`
Provider networks, facilities	`skills/networksim/SKILL.md`

PopulationSim Data Access

PopulationSim has embedded data files in skills/populationsim/data/. For lookups:

Don't write Python code for simple lookups
Use grep to find rows by FIPS code or name
Use Read to get column headers
The skill files document exact column names and data sources

Example for county lookup:

grep "06073" skills/populationsim/data/county/places_county_2024.csv
grep "06073" skills/populationsim/data/county/svi_county_2022.csv

Data Sources Reference

Dataset	File Location	Key Column
CDC PLACES (County)	`data/county/places_county_2024.csv`	CountyFIPS
SVI (County)	`data/county/svi_county_2022.csv`	STCNTY
CDC PLACES (Tract)	`data/tract/places_tract_2024.csv`	TractFIPS
SVI (Tract)	`data/tract/svi_tract_2022.csv`	FIPS
FIPS Crosswalk	`data/crosswalks/fips_county.csv`	county_fips

Key Principles

Skills contain the instructions - read them before improvising
Data is embedded - no web searches needed for demographics/SDOH
Simple tools first - grep/read before Python
Follow documented patterns - skills show exact column names and formats

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free