docs(load-graph): classify programming modules

Sixth classification batch: prog-general plus the language modules — prog-c, prog-go, prog-lisp, prog-python, prog-webdev, prog-json, prog-yaml, prog-shell, prog-training. I annotated each header, added a Batch 6 table to the inventory, and extended the validation allowlist. 52 of 102 modules are now classified.

prog-general owns the shared defaults and tree-sitter/LSP policy and stays eager. The language modules are eager only by init order and should load by major mode, so they're tagged Phase 6 deferral candidates. prog-shell's after-save executable hook is the one side effect worth scoping. No new hidden dependencies.

10 files changed, 103 insertions, 0 deletions

diff --git a/modules/prog-c.el b/modules/prog-c.el
index dbc11899..dd5d7ace 100644
--- a/modules/prog-c.el
+++ b/modules/prog-c.el
@@ -2,6 +2,16 @@
 ;; author Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
+;;
+;; Layer: 3 (Domain Workflow).
+;; Category: D/P.
+;; Load shape: eager.
+;; Eager reason: none necessary; currently eager but should load by C major mode
+;;   (Phase 6 deferral candidate).
+;; Top-level side effects: six add-hook, package configuration via use-package.
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; Modern C programming environment with LSP, tree-sitter, debugging, and formatting.
 ;;
 ;; Installation:
diff --git a/modules/prog-general.el b/modules/prog-general.el
index e7dd4989..dedf8a80 100644
--- a/modules/prog-general.el
+++ b/modules/prog-general.el
@@ -2,6 +2,16 @@
 ;; author: Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
+;;
+;; Layer: 2 (Core UX).
+;; Category: C/P/S.
+;; Load shape: eager.
+;; Eager reason: generic programming defaults, projectile, and the tree-sitter /
+;;   LSP policy shared across every language mode.
+;; Top-level side effects: four add-hook, package configuration via use-package.
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; This module provides general programming functionality not related to a
 ;; specific programming language, such as code-folding, project management,
 ;; highlighting symbols, snippets, and whitespace management.
diff --git a/modules/prog-go.el b/modules/prog-go.el
index 0d271617..0edfc206 100644
--- a/modules/prog-go.el
+++ b/modules/prog-go.el
@@ -2,6 +2,16 @@
 ;; author Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
+;;
+;; Layer: 3 (Domain Workflow).
+;; Category: D/P.
+;; Load shape: eager.
+;; Eager reason: none necessary; currently eager but should load by Go major
+;;   mode (Phase 6 deferral candidate).
+;; Top-level side effects: package configuration via use-package (hooks via :hook).
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; Configuration for Go programming using go-ts-mode (tree-sitter based).
 ;; Requires go-mode package for gofmt and related commands.
 ;;
diff --git a/modules/prog-json.el b/modules/prog-json.el
index 6dba6dee..7b49dff1 100644
--- a/modules/prog-json.el
+++ b/modules/prog-json.el
@@ -2,6 +2,16 @@
 ;; Author: Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
+;;
+;; Layer: 3 (Domain Workflow).
+;; Category: D/P.
+;; Load shape: eager.
+;; Eager reason: none necessary; currently eager but should load by JSON major
+;;   mode (Phase 6 deferral candidate).
+;; Top-level side effects: one add-hook, package configuration via use-package.
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; JSON editing with tree-sitter highlighting, one-key formatting, and
 ;; interactive jq queries against the current buffer.
 ;;
diff --git a/modules/prog-lisp.el b/modules/prog-lisp.el
index f82af40c..a5111669 100644
--- a/modules/prog-lisp.el
+++ b/modules/prog-lisp.el
@@ -2,6 +2,16 @@
 ;; author Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
+;;
+;; Layer: 3 (Domain Workflow).
+;; Category: D/P.
+;; Load shape: eager.
+;; Eager reason: none necessary; currently eager but should load by Lisp major
+;;   modes (Phase 6 deferral candidate).
+;; Top-level side effects: two add-hook, package configuration via use-package.
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; Configuration for Emacs Lisp, Common Lisp (SLIME), and Scheme (Guile).
 
 ;; ==== Common Lisp Setup (SLIME + Quicklisp) ====
diff --git a/modules/prog-python.el b/modules/prog-python.el
index 5f9a4175..d8556c4d 100644
--- a/modules/prog-python.el
+++ b/modules/prog-python.el
@@ -2,6 +2,17 @@
 ;; author Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
+;;
+;; Layer: 3 (Domain Workflow).
+;; Category: D/P.
+;; Load shape: eager.
+;; Eager reason: none necessary; currently eager but should load by Python major
+;;   mode (Phase 6 deferral candidate).
+;; Top-level side effects: package configuration via use-package; warns at load
+;;   if pyright is missing.
+;; Runtime requires: system-lib.
+;; Direct test load: yes.
+;;
 ;; Python programming environment with LSP, tree-sitter, and formatting.
 ;;
 ;; Installation:
diff --git a/modules/prog-shell.el b/modules/prog-shell.el
index 57347cc6..ca990c61 100644
--- a/modules/prog-shell.el
+++ b/modules/prog-shell.el
@@ -2,6 +2,17 @@
 ;; author Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
+;;
+;; Layer: 3 (Domain Workflow).
+;; Category: D/P/S.
+;; Load shape: eager.
+;; Eager reason: none necessary; currently eager but should load by shell major
+;;   mode (Phase 6 deferral candidate).
+;; Top-level side effects: five add-hook, including an after-save executable hook
+;;   the spec flags as needing opt-in/scoping; package config via use-package.
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; Modern shell scripting environment with LSP, tree-sitter, linting, and formatting.
 ;;
 ;; Installation:
diff --git a/modules/prog-training.el b/modules/prog-training.el
index 9eb5a9a3..41f3053b 100644
--- a/modules/prog-training.el
+++ b/modules/prog-training.el
@@ -1,6 +1,16 @@
 ;;; prog-training.el --- Training -*- lexical-binding: t; coding: utf-8; -*-
 ;; author: Craig Jennings <c@cjennings.net>
 ;;; Commentary:
+;;
+;; Layer: 4 (Optional).
+;; Category: O/D/P.
+;; Load shape: eager.
+;; Eager reason: none; the C-h E / C-h L bindings already autoload their
+;;   packages, so the eager require can drop to autoloads in Phase 4.
+;; Top-level side effects: package configuration via use-package (autoloaded).
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; Use C-h E to launch Exercism when you want to fetch or submit practice problems.
 ;; Use C-h L for LeetCode sessions; the package drops solved files under ~/code/leetcode in Go format.
 ;; Both bindings autoload their packages, so invoking the key is the whole workflow.
diff --git a/modules/prog-webdev.el b/modules/prog-webdev.el
index fbe3825c..74cff732 100644
--- a/modules/prog-webdev.el
+++ b/modules/prog-webdev.el
@@ -2,6 +2,17 @@
 ;; Author: Craig Jennings <c@cjennings.net>
 ;;
 ;;; Commentary:
+;;
+;; Layer: 3 (Domain Workflow).
+;; Category: D/P.
+;; Load shape: eager.
+;; Eager reason: none necessary; currently eager but should load by web major
+;;   modes (Phase 6 deferral candidate).
+;; Top-level side effects: package configuration via use-package; warns at load
+;;   if prettier is missing.
+;; Runtime requires: system-lib.
+;; Direct test load: yes.
+;;
 ;; TypeScript, JavaScript, and HTML development with tree-sitter, LSP, and
 ;; prettier formatting.
 ;;
diff --git a/modules/prog-yaml.el b/modules/prog-yaml.el
index 8411f04c..6bb11a62 100644
--- a/modules/prog-yaml.el
+++ b/modules/prog-yaml.el
@@ -2,6 +2,16 @@
 ;; author: Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
+;;
+;; Layer: 3 (Domain Workflow).
+;; Category: D/P.
+;; Load shape: eager.
+;; Eager reason: none necessary; currently eager but should load by YAML major
+;;   mode (Phase 6 deferral candidate).
+;; Top-level side effects: one add-hook, package configuration via use-package.
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; YAML editing with tree-sitter highlighting and one-key formatting.
 ;;
 ;; Features: