Medox docs-up

Audit code changes on the current branch and update docs/ + .claude/rules/ to stay in sync. Run before /pr.

install

source · Clone the upstream repo

git clone https://github.com/spideystreet/medox

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/spideystreet/medox "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/docs-up" ~/.claude/skills/spideystreet-medox-docs-up && rm -rf "$T"

manifest: .claude/skills/docs-up/SKILL.md

source content

Skill: Sync Docs

Audit all code changes on the current branch vs main, then update documentation files to reflect those changes.

Steps

1. Identify what changed

git diff main...HEAD --name-only

Categorize changed files into impact zones:

Changed path pattern	Docs impact
`src/medox/agent/tools/`	`docs/agent/tools.mdx` , `.claude/rules/agent.md`
`src/medox/agent/nodes/`	`docs/agent/overview.mdx` , `docs/agent/guardrails.mdx`
`src/medox/agent/graph_agent.py`	`docs/agent/overview.mdx`
`src/medox/pipeline/assets/`	`docs/pipeline/overview.mdx` , `.claude/rules/pipeline.md`
`src/medox/pipeline/io/`	`docs/pipeline/silver.mdx` , `docs/pipeline/bronze.mdx`
`dbt/models/silver/`	`docs/dbt/overview.mdx` , `docs/pipeline/silver.mdx` , `.claude/rules/dbt.md`
`dbt/models/sources.yml`	`docs/dbt/overview.mdx` , `docs/pipeline/silver.mdx`
`tests/e2e/prompts.yaml`	no docs change needed
`tests/` (other)	no docs change needed
`scripts/`	`docs/development/setup.mdx` (if new script)

2. For each impacted doc, read it and check for staleness

For each doc file identified above:

Read the current doc file
Read the changed source files
Compare: are there new entities (tools, models, assets, nodes) missing from the doc?
Compare: are there renamed/removed entities still referenced in the doc?
Compare: are there changed behaviors (e.g. new parameters, new strategies) not reflected?

3. Apply updates

For each stale doc:

Add new entries to tables, diagrams, and source lists
Update descriptions that no longer match the code
Remove references to deleted entities
Keep the existing style and structure of each doc file

Also check

.claude/rules/

files:

```
agent.md
```
— tools table, node list
```
pipeline.md
```
— asset graph, key files table
```
dbt.md
```
— current Silver models list

4. Report

After all edits, output a summary:

Docs synced:
- docs/agent/tools.mdx — updated check_interactions section
- docs/pipeline/overview.mdx — added new asset
- (no changes needed for docs/dbt/overview.mdx)

If no docs need updating, report: "All docs are up to date."

Rules

Never rewrite entire sections — make minimal, targeted edits
Keep all docs in English (same as code comments)
Do not touch
```
docs/introduction.mdx
```
or
```
docs/quickstart.mdx
```
unless the overall architecture changed
Do not commit — leave changes staged for the user to review before
```
/pr
```