genesis-compiler 1.2.13 → 1.2.15

package/README.md

@@ -14,7 +14,7 @@ interaction.
 genesis/
   blueprint.md       non-technical product intent
   stack.md           selected technology guidance, verification, declarations, and opaque extensions
-  stack/             optional per-component Description, Guidance, Adoption, and Deslop customization
+  stack/             optional per-component Description, Guidance, Adoption, Post-change, and Deslop customization
   program/           concise explanations grouped into conceptual subsystems
 .agents/skills/
   genesis-*          Genesis workflow skills
@@ -213,18 +213,25 @@ adds its adapter through its Stack piece rather than teaching Genesis prompts
 to parse that language.
 
 At the end of a turn that changed Git-visible project files, the Stop hook asks
-Codex for two separate, bounded follow-up turns. The first reconciles the
-Blueprint and affected Program explanations from the changed paths and actual
-Git diff, then Genesis deterministically refreshes both City projections. The
-second performs the focused, behavior-preserving Deslop pass, after which both
-Cities are refreshed again to reflect any cleanup. A project with no selected
+Codex for bounded follow-up turns. When the selected Stack contributes
+`Post-change` work, all contributions compose deterministically into one
+optional code-changing turn. Genesis then reconciles the Blueprint and affected
+Program explanations from the complete changed-path set and actual Git diff,
+and refreshes both City projections. A focused, behavior-preserving Deslop pass
+runs before both Cities are refreshed again. Genesis then requests one concise
+user-facing summary using conversation context only; that final phase is not
+Stack-configurable and cannot schedule more cleanup. A project with no selected
 Stack uses only the `genesis-deslop` skill. Selected Stack components enrich
-reconciliation and cleanup with their general Guidance, and enrich cleanup
-further with technology-specific Deslop guidance.
+Post-change work, reconciliation, and cleanup with general Guidance, and enrich
+cleanup further with technology-specific Deslop guidance.
 
 The hook never starts another Codex process. Its small per-session phase is
-limited to `implementation -> reconcile -> deslop -> done`, so it cannot keep
-continuing recursively. Question-only and unchanged turns finish normally.
+limited to `implementation -> optional post-change -> reconcile -> deslop ->
+summary -> done`, so it cannot keep continuing recursively. The summary prompt
+forbids repository inspection, tools, commands, tests, and edits, and the next
+Stop always clears the sequence rather than scheduling more work. Empty
+Post-change content is skipped rather than producing an empty turn.
+Question-only and unchanged turns finish normally.
 
 Projects can customize a selected technology through its matching file, such
 as `genesis/stack/jskit.md`:
@@ -242,6 +249,10 @@ Additional project-specific context about how JSKIT is used here.
 
 - Additional project-specific implementation and review guidance.
 
+### Post-change
+
+- Additional project-specific work to perform once after implementation.
+
 ### Deslop
 
 - Additional project-specific cleanup guidance.
@@ -256,6 +267,10 @@ A replacement for the installed JSKIT description.
 
 - Replacement installed implementation and review guidance.
 
+### Post-change
+
+- Replacement installed post-change work.
+
 ### Deslop
 
 - Replacement installed cleanup guidance.
@@ -263,10 +278,10 @@ A replacement for the installed JSKIT description.
 
 Every field is optional. For each field, Genesis uses the installed value,
 replaces it when `Override` supplies that field, then appends the corresponding
-`Add` content. Customization affects only `Description`, `Guidance`, and
-`Deslop`; component dependencies, Agent Skill source, resources, and
-verification commands retain their installed contracts. `genesis stack add`
-preserves these matching customization files.
+`Add` content. Customization affects only `Description`, `Guidance`,
+`Adoption`, `Post-change`, and `Deslop`; component dependencies, Agent Skill
+source, resources, and verification commands retain their installed contracts.
+`genesis stack add` preserves these matching customization files.
 
 Prompt generation remains available for other agents and explicit tasks:
 
@@ -350,6 +365,7 @@ Components may contribute:
 
 - a concise description and supplemental Guidance used across relevant tasks;
 - existing-project Adoption requirements used only while importing a codebase;
+- optional Post-change work composed once after a code-changing implementation;
 - one authoritative Agent Skill directory when the component owns one;
 - generic external-resource requirements;
 - cleanup advice used by explicit and automatic Deslop prompts;
@@ -358,7 +374,8 @@ Components may contribute:
 
 Technology-specific supplemental rules intentionally remain in Stack pieces.
 General `Guidance` enriches implementation, review, Program, description, and
-cleanup tasks; `Adoption` adds import-only requirements; `Deslop` adds
+cleanup tasks; `Adoption` adds import-only requirements; `Post-change` composes
+one optional code-changing continuation before explanation; `Deslop` adds
 cleanup-only rules. None shadows an official generic technology skill or
 assumes that an upstream skill contains every rule Genesis needs.
 
@@ -383,10 +400,10 @@ command without a shell. A complete successful run writes only
 - the commands that passed.
 
 The evidence becomes stale when code, selected components, declared resources,
-or verification commands change. Description, Guidance, Adoption, Agent Skill, and Deslop
-prose do not rewrite what an already-run command proved. A failed verification
-removes prior passing evidence before running. Verification does not claim
-whole-product correctness.
+or verification commands change. Description, Guidance, Adoption, Post-change,
+Agent Skill, and Deslop prose do not rewrite what an already-run command proved.
+A failed verification removes prior passing evidence before running.
+Verification does not claim whole-product correctness.
 
 A project can replace component defaults in `genesis/stack.md`:
 

package/docs/assurance-model.md

@@ -17,7 +17,7 @@ Genesis reports only facts it can establish mechanically:
    City projects the Program modules and source citations that exist. Neither
    proves semantic equivalence, complete dynamic dispatch, or true duplication.
 
-Prompt text, Stack Description/Guidance/Adoption/Deslop prose, Program prose, Agent Skill
+Prompt text, Stack Description/Guidance/Adoption/Post-change/Deslop prose, Program prose, Agent Skill
 content, and agent output are not assurance evidence. Genesis does not claim
 that product intent and code have converged, that Program is complete or
 semantically current, or that passing checks prove the whole product correct.

package/docs/prompt-integration.md

@@ -74,14 +74,19 @@ hosts can call `adoptProject()` and send its `prompt` directly.
 
 Codex can instead use the project-local hooks installed by `genesis init`.
 Those hooks inject a short operating guide, record whether the current turn
-changed project files, then request two bounded continuations: first reconcile
-Blueprint and affected Program explanations from the Git-visible changes, then
-Deslop the implementation. They invoke the same Genesis project operations and
-never start another agent process. A per-session phase permits only
-`implementation -> reconcile -> deslop -> done`. Genesis refreshes both City
-projections after reconciliation so Deslop sees the current explanation and
-function inventory, then refreshes them again after Deslop in case cleanup
-changed the implementation map.
+changed project files, then request bounded continuations. Selected
+`Post-change` contributions compose into one optional code-changing turn;
+Genesis then reconciles Blueprint and affected Program explanations from the
+complete Git-visible change set and Deslops the implementation. One final
+summary prompt then asks for a concise user-facing account from conversation
+context only, forbids tools and edits, and cannot schedule more cleanup. The
+hooks invoke the same Genesis project operations and never start another agent
+process. A per-session phase permits only `implementation -> optional
+post-change -> reconcile -> deslop -> summary -> done`. Empty Post-change
+content skips that phase. Genesis refreshes both City projections after
+reconciliation so Deslop sees the current explanation and function inventory,
+then refreshes them again after Deslop in case cleanup changed the
+implementation map.
 
 Once Codex identifies relevant source, `genesis context <path...>` returns only
 Program modules citing those paths plus concise selected Stack context, the
@@ -99,8 +104,9 @@ This follows Agent Skills progressive disclosure and keeps official or
 user-installed generic technology skills independent.
 
 Matching files under `genesis/stack/<component>.md` may add to or override that
-selected component's Description, Guidance, Adoption, and Deslop fields. Effective
-Guidance is used by work, review, Program, describe, Deslop, and path-context
-generation. The Codex continuation flow also carries it into reconciliation and
-cleanup; effective Deslop guidance remains cleanup-only. Effective Adoption
+selected component's Description, Guidance, Adoption, Post-change, and Deslop
+fields. Effective Guidance is used by work, review, Program, describe, Deslop,
+and path-context generation. The Codex continuation flow also carries it into
+Post-change work, reconciliation, and cleanup; effective Post-change work runs
+once before reconciliation, while Deslop guidance remains cleanup-only. Effective Adoption
 guidance is included only in the adoption workflow.

package/docs/stack-components.md

@@ -68,6 +68,10 @@ Concise technology context.
 
 - Existing-project import guidance.
 
+## Post-change
+
+- Optional work to perform once after a code-changing implementation turn.
+
 ## Deslop
 
 - Technology-specific cleanup guidance.
@@ -82,9 +86,10 @@ Concise technology context.
 ```
 ````
 
-`Description`, `Guidance`, `Adoption`, and `Deslop` are prose. `Requires` and
-`Conflicts` define component selection. `Skill` names one complete authoritative
-Agent Skill directory. `Indexers` selects installed structural adapters.
+`Description`, `Guidance`, `Adoption`, `Post-change`, and `Deslop` are prose.
+`Requires` and `Conflicts` define component selection. `Skill` names one
+complete authoritative Agent Skill directory. `Indexers` selects installed
+structural adapters.
 `Resources`, `Environment defaults`, `Environment files`, and `Verification`
 use the small Genesis grammars documented below. Every other `##` section is an
 opaque extension.
@@ -155,8 +160,8 @@ contract therefore stales prior Genesis verification evidence even though
 Genesis does not interpret the extension.
 
 Prose and Agent Skill contents are instructions rather than verification
-evidence. Changes to Description, Guidance, Adoption, Deslop, or the installed
-Skill do not rewrite what an already-run command proved.
+evidence. Changes to Description, Guidance, Adoption, Post-change, Deslop, or
+the installed Skill do not rewrite what an already-run command proved.
 
 `City regions` and `Indexers` control only the derived structural maps. Indexers
 identify language adapters. City regions can exclude test/spec paths and group
@@ -177,6 +182,10 @@ A selected component may have one prose-only customization at
 
 - Additional project guidance.
 
+### Post-change
+
+- Additional project-specific post-change work.
+
 ## Override
 
 ### Deslop
@@ -184,9 +193,10 @@ A selected component may have one prose-only customization at
 - Replacement cleanup guidance.
 ```
 
-Customizations may add or override only Description, Guidance, Adoption, and
-Deslop. They cannot mutate selection, resources, environment declarations,
-Verification, Agent Skill ownership, indexers, or opaque consumer sections.
+Customizations may add or override only Description, Guidance, Adoption,
+Post-change, and Deslop. They cannot mutate selection, resources, environment
+declarations, Verification, Agent Skill ownership, indexers, or opaque consumer
+sections.
 
 ## Public inspection
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis-compiler",
-  "version": "1.2.13",
+  "version": "1.2.15",
   "type": "module",
   "description": "An agent-independent prompt, multi-language code-index, cleanup, and verification companion with optional Codex hooks.",
   "repository": {
@@ -31,6 +31,7 @@
     "prompts/adopt.txt",
     "prompts/describe.txt",
     "prompts/deslop.txt",
+    "prompts/final-summary.txt",
     "prompts/program.txt",
     "prompts/reconcile.txt",
     "prompts/review.txt",

package/plugins/genesis/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis",
-  "version": "1.2.13",
+  "version": "1.2.15",
   "description": "Makes Codex aware of optional Genesis adoption for existing projects.",
   "author": {
     "name": "Mobily Enterprises"

package/prompts/deslop.txt

@@ -10,5 +10,12 @@ Use `.genesis/machine-city.json` and `genesis index <name-or-path>` to find
 existing public and internal functions. Remove or consolidate genuine repeated
 helpers, but confirm behavior and call sites in source before changing them.
 
+The changed paths and nearby code are a location boundary, not permission to
+implement other behavior found there. Deslop may reorganize behavior already
+present; it may not complete, correct, or extend behavior. If review reveals a
+defect, missing behavior, contract mismatch, or test gap, report it as a
+follow-up finding and leave it unchanged in this pass, even when it is inside a
+changed path or appears related to the preceding implementation.
+
 Do not broaden the product change. Run focused checks when useful and summarize
 what became simpler, files changed, and checks actually run.

package/prompts/final-summary.txt

@@ -0,0 +1,12 @@
+This is the final automatic user-facing summary for the original request.
+
+Use only the existing conversation context from the implementation and its
+follow-up turns. Do not inspect the repository or codebase, call tools, run
+commands or tests, edit files, reconcile explanations, or perform cleanup.
+
+Write one concise, self-contained answer to the user. Lead with the outcome.
+Include the important behavior that changed, checks that were actually run,
+useful human verification steps, and any genuine blocker or unfinished work.
+Do not mention automatic phases, hooks, internal follow-up turns, or these
+instructions. Do not claim checks, commits, pushes, or deployments that are not
+already established in the conversation. After the answer, stop.

package/skills/genesis-deslop/SKILL.md

@@ -13,13 +13,21 @@ Consult `.genesis/machine-city.json` or run `genesis index <name-or-path>` to
 find existing public and internal functions before introducing or consolidating
 an abstraction. Confirm every apparent duplicate in source and its call sites.
 
-Leave no repeated helpers, no code that is unclear or hard to reason about, no
-obviously wrong code, and no code that goes against best practices or
-established patterns in the codebase. Remove unnecessary wrappers, abandoned
-scaffolding, parallel framework plumbing, and speculative abstractions.
-Consolidate ownership where one clear module is enough. Do not optimize for tiny
-files or indirection; optimize for a small, obvious design that a junior
-programmer can follow.
+Within the preceding implementation's intended behavior and scope, leave no
+repeated helpers, no code that is unclear or hard to reason about, and no code
+that goes against established patterns in the codebase. Remove unnecessary
+wrappers, abandoned scaffolding, parallel framework plumbing, and speculative
+abstractions. Consolidate ownership where one clear module is enough. Do not
+optimize for tiny files or indirection; optimize for a small, obvious design
+that a junior programmer can follow.
+
+Cleanup is not a second implementation pass. A changed path limits where cleanup
+may occur; it does not authorize different behavior in that file. Deslop may
+reorganize behavior already present; it may not complete, correct, or extend
+behavior. If review reveals a defect, missing behavior, contract mismatch, or
+test gap, report it as a follow-up finding and leave it unchanged, even when it
+is inside a changed path or appears related to the preceding implementation. Do
+not implement the finding or alter tests to accommodate it during Deslop.
 
 Apply every technology-specific Deslop instruction supplied by the selected
 Stack. Load applicable official technology skills for additional framework and

package/src/index/assets.js

@@ -8,6 +8,7 @@ const assets = {
   describe: new URL('prompts/describe.txt', root),
   reconcile: new URL('prompts/reconcile.txt', root),
   deslop: new URL('prompts/deslop.txt', root),
+  finalSummary: new URL('prompts/final-summary.txt', root),
   program: new URL('prompts/program.txt', root),
   blueprint: new URL('prompts/blueprint.txt', root),
   review: new URL('prompts/review.txt', root),

package/src/index/codex-hooks.js

@@ -134,8 +134,8 @@ export async function codexSessionContext({ projectRoot } = {}) {
       '- Before creating a helper or public operation, run `genesis index <name-or-path>` and reuse an existing function when it already owns the behavior.',
       '- `.genesis/machine-city.json` is the detailed code/function map; `.genesis/program-city.json` is the simpler subsystem/operation map.',
       '- Program is fallible explanation; code, tests, and runtime behavior remain evidence.',
-      '- Keep implementation focused; the Stop hook owns later Blueprint/Program reconciliation and Deslop turns.',
-      '- After a code-changing turn, Genesis may request separate explanation and behavior-preserving cleanup turns.',
+      '- Keep implementation focused; the Stop hook owns optional Stack Post-change work, Blueprint/Program reconciliation, and Deslop turns.',
+      '- After a code-changing turn, Genesis may request separate post-change, explanation, cleanup, and final-summary turns.',
       `Selected Stack components: ${stackStatus}.`,
     ].join('\n'),
   };
@@ -173,8 +173,12 @@ function hookId(input, field) {
   return value;
 }
 
+function normalizedPaths(values = []) {
+  return [...new Set(values.map(normalizeRelative).filter(Boolean))];
+}
+
 function zeroPaths(buffer) {
-  return buffer.toString('utf8').split('\0').filter(Boolean).map(normalizeRelative);
+  return normalizedPaths(buffer.toString('utf8').split('\0'));
 }
 
 async function repositorySnapshot(projectRoot) {
@@ -292,6 +296,24 @@ async function reconciliationContinuation(projectRoot, changedPaths) {
   ].join('\n');
 }
 
+function postChangeContinuation(changedPaths, stack) {
+  return [
+    'This is the one automatic Stack Post-change turn for the preceding implementation.',
+    'Use the same conversation context and the Git-visible changes below.',
+    'Perform only the composed Post-change work. Do not broaden the task, reconcile Genesis explanations, or perform Deslop yet.',
+    'Do not repeat or schedule another Post-change turn. If none of the configured work applies, make no changes and respond minimally.',
+    '',
+    'CHANGED PROJECT PATHS',
+    '',
+    ...changedPathLines(changedPaths),
+    '',
+    'COMPOSED STACK POST-CHANGE WORK',
+    '',
+    stack.postChange,
+    ...(stack.guidance ? ['', 'SELECTED STACK GUIDANCE', '', stack.guidance] : []),
+  ].join('\n');
+}
+
 async function deslopContinuation(projectRoot, changedPaths) {
   const [instructions, stack] = await Promise.all([
     readInstalledAsset('deslop'),
@@ -318,6 +340,10 @@ async function deslopContinuation(projectRoot, changedPaths) {
   ].join('\n');
 }
 
+async function finalSummaryContinuation() {
+  return (await readInstalledAsset('finalSummary')).trim();
+}
+
 export async function completeCodexTurn({ input, projectRoot } = {}) {
   const root = (await gitContext(projectRoot || input?.cwd)).repositoryRoot;
   const statePath = await hookStatePath(root, input);
@@ -334,14 +360,18 @@ export async function completeCodexTurn({ input, projectRoot } = {}) {
       await rm(statePath, { force: true });
       return {};
     }
+    const stack = await optionalStack(root);
+    const postChange = Boolean(stack?.postChange?.trim());
     await writeTurnState(statePath, {
       ...state,
-      phase: 'reconcile',
+      phase: postChange ? 'post-change' : 'reconcile',
       changedPaths,
     });
     return {
       decision: 'block',
-      reason: await reconciliationContinuation(root, changedPaths),
+      reason: postChange
+        ? postChangeContinuation(changedPaths, stack)
+        : await reconciliationContinuation(root, changedPaths),
     };
   }
 
@@ -350,9 +380,32 @@ export async function completeCodexTurn({ input, projectRoot } = {}) {
     return {};
   }
 
+  if (state.phase === 'post-change') {
+    const currentPaths = await changedProjectPaths(root, state.snapshot, await repositorySnapshot(root));
+    const changedPaths = normalizedPaths([...state.changedPaths, ...currentPaths]).sort();
+    if (changedPaths.length === 0) {
+      await rm(statePath, { force: true });
+      return {};
+    }
+    await writeTurnState(statePath, {
+      ...state,
+      phase: 'reconcile',
+      changedPaths,
+    });
+    return {
+      decision: 'block',
+      reason: await reconciliationContinuation(root, changedPaths),
+    };
+  }
+
   if (state.phase === 'reconcile') {
     const currentPaths = await changedProjectPaths(root, state.snapshot, await repositorySnapshot(root));
-    const changedPaths = [...new Set([...state.changedPaths, ...currentPaths])].sort();
+    const changedPaths = normalizedPaths([...state.changedPaths, ...currentPaths]).sort();
+    if (changedPaths.length === 0) {
+      await refreshProjectIndex(root);
+      await rm(statePath, { force: true });
+      return {};
+    }
     await refreshProjectIndex(root);
     await writeTurnState(statePath, {
       ...state,
@@ -365,7 +418,18 @@ export async function completeCodexTurn({ input, projectRoot } = {}) {
     };
   }
 
-  await refreshProjectIndex(root);
+  if (state.phase === 'deslop') {
+    await refreshProjectIndex(root);
+    await writeTurnState(statePath, {
+      ...state,
+      phase: 'summary',
+    });
+    return {
+      decision: 'block',
+      reason: await finalSummaryContinuation(),
+    };
+  }
+
   await rm(statePath, { force: true });
   return {};
 }

package/src/index/prompt.js

@@ -4,6 +4,7 @@ import { buildProjectIndex, MACHINE_CITY_PATH, PROGRAM_CITY_PATH } from './code-
 import { BLUEPRINT_SKELETON_SOURCE, readBlueprint } from './blueprint.js';
 import { readStack, stackPromptContext } from './stack.js';
 import { listStackCatalogPieces } from './stack-catalog.js';
+import { normalizeStackPieceId } from './stack-piece.js';
 import { GenesisError } from './errors.js';
 import { gitContext } from './git.js';
 import { inspectProgram } from './program.js';
@@ -25,13 +26,16 @@ const DEFAULT_REQUEST = {
   review: 'Review the complete useful relationship between Blueprint, code, Program, and tests.',
 };
 
-function stackCatalogContext(pieces = []) {
-  return pieces.map(({ id, description, requires, conflicts }) => ({
-    id,
-    description,
-    requires,
-    conflicts,
-  }));
+function stackCatalogContext(pieces = [], hiddenStackPieces = []) {
+  const hidden = new Set(hiddenStackPieces.map(normalizeStackPieceId));
+  return pieces
+    .filter(({ id }) => !hidden.has(id))
+    .map(({ id, description, requires, conflicts }) => ({
+      id,
+      description,
+      requires,
+      conflicts,
+    }));
 }
 
 function requestText(value, task) {
@@ -205,7 +209,14 @@ async function generateExplanationPrompt({ instructions, program, request, root,
   };
 }
 
-async function generateStartPrompt({ instructions, program, request, root, stackPackages }) {
+async function generateStartPrompt({
+  hiddenStackPieces,
+  instructions,
+  program,
+  request,
+  root,
+  stackPackages,
+}) {
   let blueprint;
   try {
     blueprint = await readBlueprint(root, { required: true });
@@ -255,7 +266,7 @@ async function generateStartPrompt({ instructions, program, request, root, stack
           description: blueprint.description,
         },
         stack: stackPromptContext(stack),
-        availableStackPieces: stackCatalogContext(catalog),
+        availableStackPieces: stackCatalogContext(catalog, hiddenStackPieces),
         program: programContext(program),
         codeIndex: codeIndexContext(index),
       },
@@ -273,6 +284,7 @@ async function generateStartPrompt({ instructions, program, request, root, stack
 
 export async function generateProjectPrompt({
   environment = process.env,
+  hiddenStackPieces = [],
   projectRoot,
   request = '',
   stackPackages = [],
@@ -314,6 +326,7 @@ export async function generateProjectPrompt({
   if (task === 'start') {
     return generateStartPrompt({
       instructions,
+      hiddenStackPieces,
       program,
       request: userRequest,
       root,
@@ -338,6 +351,7 @@ export async function generateProjectPrompt({
       if (error?.code !== 'STACK_REQUIRED') throw error;
       return generateStartPrompt({
         instructions: await readInstalledAsset('start'),
+        hiddenStackPieces,
         program,
         request: userRequest,
         root,
@@ -347,6 +361,7 @@ export async function generateProjectPrompt({
     if (stack.components.length === 0) {
       return generateStartPrompt({
         instructions: await readInstalledAsset('start'),
+        hiddenStackPieces,
         program,
         request: userRequest,
         root,

package/src/index/stack-piece.js

@@ -8,7 +8,13 @@ import { normalizeSource } from './utils.js';
 
 const STACK_PIECE_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 const STACK_CUSTOMIZATION_TITLE = /^# Stack customization: ([a-z0-9]+(?:-[a-z0-9]+)*)\s*$/u;
-const STACK_CUSTOMIZATION_FIELDS = new Set(['Description', 'Guidance', 'Adoption', 'Deslop']);
+const STACK_CUSTOMIZATION_FIELDS = new Map([
+  ['Description', 'description'],
+  ['Guidance', 'guidance'],
+  ['Adoption', 'adoption'],
+  ['Post-change', 'postChange'],
+  ['Deslop', 'deslop'],
+]);
 const STACK_PIECE_SECTIONS = new Set([
   'Adoption',
   'City regions',
@@ -19,6 +25,7 @@ const STACK_PIECE_SECTIONS = new Set([
   'Environment files',
   'Guidance',
   'Indexers',
+  'Post-change',
   'Requires',
   'Resources',
   'Skill',
@@ -73,7 +80,7 @@ function customizationSections(source, piecePath) {
     if (!field) return;
     const value = content.join('\n').trim();
     if (!value) invalid(piecePath, `Stack customization ${mode} ${field} must not be empty.`);
-    result[mode.toLowerCase()][field.toLowerCase()] = value;
+    result[mode.toLowerCase()][STACK_CUSTOMIZATION_FIELDS.get(field)] = value;
     field = null;
     content = [];
   }
@@ -96,7 +103,7 @@ function customizationSections(source, piecePath) {
       if (!mode || !STACK_CUSTOMIZATION_FIELDS.has(fieldHeading[1])) {
         invalid(piecePath, `Unknown or misplaced customization field: ${fieldHeading[1]}.`);
       }
-      const key = fieldHeading[1].toLowerCase();
+      const key = STACK_CUSTOMIZATION_FIELDS.get(fieldHeading[1]);
       if (Object.hasOwn(result[mode.toLowerCase()], key)) {
         invalid(piecePath, `Duplicate ${mode} ${fieldHeading[1]} customization.`);
       }
@@ -106,12 +113,12 @@ function customizationSections(source, piecePath) {
     if (/^#{1,3}\s+/u.test(line)) invalid(piecePath, `Unknown customization heading: ${line.trim()}.`);
     if (field) content.push(line);
     else if (line.trim()) {
-      invalid(piecePath, 'Customization content must be below Description, Guidance, Adoption, or Deslop.');
+      invalid(piecePath, 'Customization content must be below Description, Guidance, Adoption, Post-change, or Deslop.');
     }
   }
   finishField();
   if (Object.values(result).every((values) => Object.keys(values).length === 0)) {
-    invalid(piecePath, 'Stack customization must add or override Description, Guidance, Adoption, or Deslop.');
+    invalid(piecePath, 'Stack customization must add or override Description, Guidance, Adoption, Post-change, or Deslop.');
   }
   return result;
 }
@@ -243,6 +250,7 @@ export function parseStackPieceSource(value, {
   const description = textSection(all, 'Description');
   const guidance = textSection(all, 'Guidance');
   const adoption = textSection(all, 'Adoption');
+  const postChange = textSection(all, 'Post-change');
   const deslop = textSection(all, 'Deslop');
   if (!description) invalid(piecePath, 'Stack piece needs Description.');
   const verificationCommands = parseStackVerificationLines(
@@ -266,6 +274,7 @@ export function parseStackPieceSource(value, {
     description,
     guidance,
     adoption,
+    postChange,
     requires: idList(all, 'Requires', piecePath, { required: true }),
     conflicts: idList(all, 'Conflicts', piecePath),
     indexers: idList(all, 'Indexers', piecePath),
@@ -320,6 +329,11 @@ export function applyStackPieceCustomization(piece, customization) {
       customization.override.adoption,
       customization.add.adoption,
     ),
+    postChange: customizedText(
+      piece.postChange,
+      customization.override.postChange,
+      customization.add.postChange,
+    ),
     deslop: customizedText(piece.deslop, customization.override.deslop, customization.add.deslop),
   };
 }

package/src/index/stack.js

@@ -362,6 +362,7 @@ export async function readStack(projectRoot, { stackPackages = [] } = {}) {
     resources,
     guidance: composedProse(components, 'guidance'),
     adoption: composedProse(components, 'adoption'),
+    postChange: composedProse(components, 'postChange'),
     deslop: composedProse(components, 'deslop'),
   };
 }