Template Infrastructure Module

Infrastructure module

Natural invoke

• "Add infrastructure/foo/ package with CLI and tests"
• "Extend infrastructure/validation with a new gate"
• "New generic utility reusable across projects"

Inputs to confirm

• Module name — under infrastructure//.
• Public API — functions/classes to export in __init__.py and __all__.

Workflow

1. Layout — __init__.py, core logic module(s), optional cli.py, AGENTS.md, README.md, SKILL.md with YAML frontmatter.

1. Implement — generic (no project-specific paths hard-coded); type hints; TemplateError hierarchy.

1. Tests — tests/infra_tests//; no mocks; ≥60% on infrastructure/.

1. Exports — re-exporting __init__.py must declare __all__ (MED5).

1. Register skill — uv run python -m infrastructure.skills write after adding SKILL.md.

1. Wire docs — update infrastructure/AGENTS.md module map if significant.

Deliverables

• Package tree + test path
• Coverage snippet from pytest

Verification commands

uv run pytest tests/infra_tests// -v --cov=infrastructure --cov-fail-under=60
uv run python -m infrastructure.skills check
uv run python -m infrastructure.skills check --all-exports

When NOT to use

• Project-specific domain code → [code-development](../code-development/SKILL.md) in projects/*/src/

References

• [infrastructure/AGENTS.md](../../../infrastructure/AGENTS.md)
• [docs/rules/api_design.md](../../rules/api_design.md) — __all__ for re-exporters

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: docxology
• Source: docxology/template
• License: Apache-2.0
• Homepage: https://doi.org/10.5281/zenodo.19139090

Install and usage instructions live in the source repository linked above.