punkshell/src/modules_tcl8/AGENTS.md

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)