| name | 0.2.1-understand-coc_001 |
| description | [0.2.1] commented_code_element: a syntactic unit of source code that has been rendered inactive by enclosing it in com |
understand-coc_001
CALL NUMBER: deep_dispensables.coc_001
DEFINITION: commented_code_element: a syntactic unit of source code that has been rendered inactive by enclosing it in comment syntax, producing no observable execution behavior while remaining visible in the source text.
Invoke this skill to understand coc_001 down to its primitives. The RELATIVE ROOT below is the least-fixed-point closure of everything it bundles from — the full import cone, grouped by the lib each prim comes from. Projected from a prover-typed KB (MAP/SWI-Prolog consistency gate): every reference below resolves.
THE RELATIVE ROOT (the import cone, by lib)
from deep_dispensables
- coc_002 (d1): comment_syntax_container: the comment delimiters and surrounding text that physically bind the disabled code element, making its source legible but its semantics inert.
- coc_003 (d1): dead_execution_state: the condition of a code element whose source text exists but whose semantics are excluded from runtime interpretation.
- coc_004 (d1): rationale_annotation: an explanatory comment accompanying commented-out code that documents the reason for its disablement, often speculative or stale.
- coc_005 (d1): temporal_marker: metadata within or adjacent to commented code that indicates when it was disabled, such as a date, version number, or commit reference.
- coc_006 (d1): resurrection_intent: an expressed or implied intention within commented code to re-enable it in the future, typically indicated by TODO, FIXME, or similar markers.
- coc_007 (d1): version_control_anchor: the commit, branch, or revision at which the code element was disabled, serving as the authoritative record of its prior active state.
- coc_011 (d1): code_smell: a surface indicator in source code that suggests a potential deeper problem in design or implementation, of which commented-out code is one instance.
- coc_012 (d1): substitution_pair: an active code element that replaces or is intended to replace a commented-out element, establishing a functional successor relationship.
Projected from the refactoring catalog and code smells KB (183 concepts / 128 relations) — consistency-typed by MAP; the facet list after the colon IS the cross-lib dependency web.
(leaf — this is an actual skill.)
