infrastructure-documentationlisted
Install: claude install-skill docxology/template
# Documentation Module
Figure management, image handling, and documentation integration for research manuscripts.
## GeneratedFigureRegistry (`generated_figure_registry.py`)
Use the fail-closed writer for deterministic project pipelines. Figure labels,
filenames, captions, and qualified generator names remain project-owned; the
shared writer verifies that every declared file exists before atomically
writing `output/figures/figure_registry.json`.
```python
from infrastructure.documentation import publish_generated_figures
written = publish_generated_figures(
output_dir,
PROJECT_FIGURE_SPECS,
generated_paths,
schema_version="my-project-figure-registry-v1",
)
```
## FigureManager (`figure_manager.py`)
Automatic figure numbering, cross-referencing, and metadata tracking:
```python
from infrastructure.documentation import FigureManager, FigureMetadata
manager = FigureManager()
# Register a figure (label auto-generated from filename if omitted)
manager.register_figure(
filename="results.png",
caption="Experimental results showing...",
label="fig:results",
section="Results",
)
# Get figure metadata by label
meta = manager.get_figure("fig:results") # Returns FigureMetadata | None
```
## ImageManager (`image_manager.py`)
Image file management and processing:
```python
from pathlib import Path
from infrastructure.documentation import ImageManager, FigureManager
img_manager = ImageManager(FigureManager())
# Insert a registered figure into