Refresh documentation and policies and simplify releases

docs/internal/modules.md

@@ -2,7 +2,8 @@
 
 ## Scope
 
-This document covers module contracts and built-in module packages.
+This document covers internal module contracts and packages. User-selectable keys
+and the default sequence belong to [configuration](../config.md#pipeline-and-output).
 
 ## Module Contract
 
@@ -46,9 +47,26 @@ Module packages call the built-in chain resolver at construction.
 
 ## Failure and Warning Behavior
 
-- module setup failures surface as `runner_setup` or module setup errors;
-- module runtime failures surface as `runner_execution` with partial module results preserved;
-- malformed structured proposal payloads are downgraded to warnings and section-level proposal rejection.
+Module construction failures propagate to orchestration; execution failures can
+preserve partial module results. Malformed structured proposal payloads become
+warnings and section-level rejection. Consumer-visible outcomes are defined by
+the [report contract](../integrations/output-files.md#module-outcomes).
+
+## Changing Modules
+
+1. Add or update the narrowly scoped package under `internal/modules/<module_key>`.
+2. Keep module-specific prompt ownership in the module and `internal/prompts`;
+   see [prompt rendering and metadata](prompts.md).
+3. Wire module registration and catalog resolution through framework module
+   registration and the core module catalog. Update selectable keys in the
+   [configuration contract](../config.md) when they change.
+4. Verify replacement policy and validator-chain selection against the
+   [architecture requirements](../policy/architecture.md#correction-and-concurrency-invariants).
+5. Review module, prompt-rendering, and proposal-generation tests. Inspect parity
+   and release fixtures when public output changes, choosing sufficient coverage
+   under the [testing policy](../policy/testing.md).
+6. Update this document for implementation changes and the appropriate public
+   contract owner for externally visible changes.
 
 ## Key Tests