an.semantic.docs

The vocabulary section of the downstream an skill, generated from the registry.

ADR 0003 decision 6’s third generated surface. The skill keeps its prose; the table between the two markers is rendered here and checked by a test, so a preset, a method or a version cannot change without the skill saying so:

python -m an.semantic.docs --write .claude/skills/an/SKILL.md

Each owner renders only its own rows (an#354): an’s skill carries the core vocabulary, and a genre keeps its rows in its own skill, regenerated and checked there with --owner <genre>, so a genre change cannot turn an red.

>>> "| `walk` |" in skill_vocabulary_section() or "| `tween` |" in skill_vocabulary_section()
True

Functions

replace_section(text, section)	text with the block between the markers replaced by section.
skill_vocabulary_section(*[, owner])	The markdown between the markers: one table per kind, then the methods by aspect.

an.semantic.docs.replace_section(text, section)

text with the block between the markers replaced by section.

Return type:

str

>>> replace_section(f"a\n{BEGIN_MARKER}\nold\n{END_MARKER}\nb", "new").splitlines()[2]
'new'

an.semantic.docs.skill_vocabulary_section(*, owner='an')

The markdown between the markers: one table per kind, then the methods by aspect.

Only the rows owner registered: the core by default, a genre’s own with owner=<genre> (its skill points back here for the core rows).

Return type:

str