# src/modules_tcl8 — Tcl 8 Specific Module Source

## Purpose

Holds source modules specific to Tcl major version 8. Use only when a package or proc is specific to Tcl 8 or only exists in this tree.

## Ownership

- Agents should prefer `src/modules/` over this tree unless the task explicitly involves Tcl 8-specific behaviour.
- Files here follow the same naming and structure conventions as `src/modules/`.
- Follow the module authoring conventions in `src/modules/AGENTS.md` where they apply; this file narrows source selection and Tcl 8 compatibility rules.

## Local Contracts

- This tree holds source specific to Tcl major version 8.
- Prefer this tree only when the package or proc is specific to Tcl major version 8 or only exists here.
- Do not prefer this tree when an equivalent generic source exists in `src/modules/` unless version-specific behavior is relevant.

## Work Guidance

- Tcl 8 compatibility gates should use `if {$tcl_version < 9} { ... }` or `package require Tcl 8`.
- Use `punk::lib::compat` functions where available instead of raw version checks.

## Verification

- Tests pass under a Tcl 8.6+ interpreter.

## Child DOX Index

(None — currently empty of module files)