egohygiene · szmyty · Aug 25, 2026 · Aug 25, 2026
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -41,6 +41,10 @@ Do **not** treat `.staging/`, `dist/`, or any other path as canonical source.
 5. **Validate local Markdown links** before finalizing documentation changes.
 6. **Consumer-local instructions override Aether defaults** for that consumer's
    context.
+7. **Run the decision-impact checkpoint before code changes.** Apply the
+   canonical
+   [`decision-impact.AGENTS.md`](../library/organization/projections/templates/decision-impact.AGENTS.md)
+   module by reference; do not copy or weaken its Hygiene contract pins.
 
 ---
 

diff --git a/ROADMAP.md b/ROADMAP.md
@@ -8,7 +8,7 @@ status: draft
 owners:
   - egohygiene
 created: 2026-08-08
-updated: 2026-08-24
+updated: 2026-08-25
 governed_by:
   - architecture-roadmap
 depends_on:
@@ -33,9 +33,9 @@ repository: egohygiene/aether
 visibility: public
 publication: central
 route: /roadmap/aether/
-updated: 2026-08-24
+updated: 2026-08-25
 -->
-## 2026-08-24 execution snapshot
+## 2026-08-25 execution snapshot
 
 > This evidence-reconciled snapshot is the issue-generation and visual-roadmap handoff. The longer-horizon strategy below remains canonical context; generated HTML, JSON, progress, issue plans, and commit lists are projections.
 
@@ -187,6 +187,33 @@ issues: []
 
 - Aether already owns reusable AI artifacts; roadmap authoring support is assigned there by the visual-roadmap specification.
 
+<!-- roadmap-step
+id: AET-Q07
+status: ready
+depends_on: [AET-Q01]
+issues: [49]
+-->
+#### AET-Q07 — Add the decision-impact instruction hook
+
+**State:** `ready`
+**Depends on:** `AET-Q01`
+
+**Outcome:** Every generated agent projection receives one concise,
+version-pinned checkpoint that distinguishes consequential decisions from
+routine implementation and preserves human decision authority.
+
+**Exit criteria:**
+
+- [ ] The shared module pins, rather than copies, the proposed Hygiene ADR and Repository Intelligence contracts.
+- [ ] Create, update, supersede, reference, and `ADR not required` flows cover consequential and routine examples.
+- [ ] Provider projections and a generated repository `AGENTS.md` fixture contain exactly one managed hook.
+- [ ] Deterministic tests reject malformed or duplicate managed blocks.
+
+**Current evidence:**
+
+- Issue #49 defines the decision-impact scope and acceptance criteria.
+- The pinned Hygiene contracts remain proposed; this step must not claim their acceptance.
+
 ### Roadmap-to-issue handoff
 
 - A step is complete only when its exit criteria and required evidence are satisfied; commit count never determines progress.

diff --git a/dist/github/organization/agents/architect.agent.md b/dist/github/organization/agents/architect.agent.md
@@ -8,6 +8,7 @@ tools:
 - edit
 - web
 ---
+<!-- aether-projection {"generator":"library/organization/projections/build-projections.py","instruction_modules":[{"id":"decision-impact","inherits":[{"contract":"egohygiene.architecture-decision/v1","policy_version":"1.0.0","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/decisions/POLICY.md","status":"proposed"},{"contract":"egohygiene.repository-intelligence/v1","contract_version":"1.0.0-alpha.1","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/ecosystem/REPOSITORY_INTELLIGENCE.md","status":"proposed"}],"source":"library/organization/projections/templates/decision-impact.AGENTS.md","source_digest":{"algorithm":"sha256-utf8-lf","value":"6359706b207cc15bffa7fdbdcf093d528142b0c7675bc24dfc27534f7b015280"},"status":"draft","version":"0.1.0"}],"interface":"aether.projection-interface/v1","interface_version":"1.1.0","provider":"github-copilot","source":"library/organization/agents/architect/AGENT.md","source_digest":{"algorithm":"sha256-utf8-lf","value":"1b3dbca129e8505379ea747b084cb460a6165dfbace21e7e1e52bbe4fe6d5c51"}} -->
 
 ## Mission
 
@@ -41,3 +42,53 @@ Inspect repository evidence before describing current architecture. Skip missing
 ## Completion
 
 Finish with the architecture artifact, resolved decisions, remaining open questions, implementation boundaries, and recommended next step toward Specfile Creator.
+
+<!-- BEGIN AETHER DECISION-IMPACT -->
+<!-- aether-instruction {"id":"decision-impact","inherits":[{"contract":"egohygiene.architecture-decision/v1","policy_version":"1.0.0","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/decisions/POLICY.md","status":"proposed"},{"contract":"egohygiene.repository-intelligence/v1","contract_version":"1.0.0-alpha.1","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/ecosystem/REPOSITORY_INTELLIGENCE.md","status":"proposed"}],"status":"draft","version":"0.1.0"} -->
+## Decision-impact checkpoint
+
+Before changing code, inspect the applicable repository instructions, roadmap,
+local decisions, and relevant organization decisions. Classify the work as
+`create`, `update`, `supersede`, `reference`, or `ADR not required`. Do not
+silently make a consequential or ambiguous choice: surface it and request human
+review. Automated agents never mark an ADR accepted.
+
+- **Create** a proposed ADR when no existing record governs a consequential
+  choice.
+- **Update** an existing proposal, or add evidence/outcomes/corrections that do
+  not rewrite an accepted decision's historical meaning.
+- **Supersede** when an accepted choice must change: propose a replacement,
+  preserve the old record, and link both directions after human approval.
+- **Reference** the governing ADR when work implements an existing decision;
+  do not create a duplicate.
+- Use **`ADR not required`** with one short reason for routine, local, reversible
+  work that follows accepted design.
+
+| Area | ADR required | ADR not required |
+| --- | --- | --- |
+| Dependencies | Adopt/remove a durable framework or make a compatibility-changing major upgrade | Apply a compatible patch within accepted dependency policy |
+| Public contracts | Change API, CLI, schema, compatibility, or migration semantics | Clarify documentation or tests without changing the contract |
+| Security | Change a trust boundary, authorization model, encryption, or secret handling | Implement or test an already accepted control |
+| Data models | Change durable identity, persistence, or migration strategy | Refactor a transient local representation |
+| Deployment | Change topology, hosting platform, release channel, or dependency direction | Tune retries or resources within the accepted topology |
+| Reversible details | A trigger above still makes the choice consequential | Change a local algorithm, refactor, formatting, or test organization |
+
+When stable identifiers exist, connect the work with Git trailers or equivalent
+pull-request fields:
+
+```text
+Roadmap-Step: AET-Q07
+ADR-Ref: egohygiene/hygiene#ADR-002
+```
+
+Use a local stable ID or a fully qualified `<owner>/<repository>#<id>`; always
+qualify cross-repository references. Do not invent missing IDs or evidence.
+
+This draft module inherits the proposed
+[Hygiene ADR policy v1.0.0](https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/decisions/POLICY.md)
+and
+[Repository Intelligence v1.0.0-alpha.1](https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/ecosystem/REPOSITORY_INTELLIGENCE.md)
+at immutable revision `5e0602265b6ac5e5165b89f418e55a3fd12f8a64`.
+It grants no acceptance, implementation, or organization-wide authority while
+those upstream contracts remain proposed.
+<!-- END AETHER DECISION-IMPACT -->
diff --git a/dist/github/organization/agents/arxiv-publisher.agent.md b/dist/github/organization/agents/arxiv-publisher.agent.md
@@ -9,6 +9,7 @@ tools:
 - execute
 - web
 ---
+<!-- aether-projection {"generator":"library/organization/projections/build-projections.py","instruction_modules":[{"id":"decision-impact","inherits":[{"contract":"egohygiene.architecture-decision/v1","policy_version":"1.0.0","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/decisions/POLICY.md","status":"proposed"},{"contract":"egohygiene.repository-intelligence/v1","contract_version":"1.0.0-alpha.1","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/ecosystem/REPOSITORY_INTELLIGENCE.md","status":"proposed"}],"source":"library/organization/projections/templates/decision-impact.AGENTS.md","source_digest":{"algorithm":"sha256-utf8-lf","value":"6359706b207cc15bffa7fdbdcf093d528142b0c7675bc24dfc27534f7b015280"},"status":"draft","version":"0.1.0"}],"interface":"aether.projection-interface/v1","interface_version":"1.1.0","provider":"github-copilot","source":"library/organization/agents/arxiv-publisher/AGENT.md","source_digest":{"algorithm":"sha256-utf8-lf","value":"331dbbae27abfdc75fac579ee30a7d900b1f20d6f7d7033f295b70fb9045986a"}} -->
 
 ## Mission
 
@@ -38,3 +39,53 @@ Apply the [`prepare-arxiv-release`](.agents/skills/prepare-arxiv-release/SKILL.m
 ## Completion
 
 Report produced artifacts, exact validation performed, warnings, unresolved publisher constraints, and any manual submission steps that remain.
+
+<!-- BEGIN AETHER DECISION-IMPACT -->
+<!-- aether-instruction {"id":"decision-impact","inherits":[{"contract":"egohygiene.architecture-decision/v1","policy_version":"1.0.0","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/decisions/POLICY.md","status":"proposed"},{"contract":"egohygiene.repository-intelligence/v1","contract_version":"1.0.0-alpha.1","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/ecosystem/REPOSITORY_INTELLIGENCE.md","status":"proposed"}],"status":"draft","version":"0.1.0"} -->
+## Decision-impact checkpoint
+
+Before changing code, inspect the applicable repository instructions, roadmap,
+local decisions, and relevant organization decisions. Classify the work as
+`create`, `update`, `supersede`, `reference`, or `ADR not required`. Do not
+silently make a consequential or ambiguous choice: surface it and request human
+review. Automated agents never mark an ADR accepted.
+
+- **Create** a proposed ADR when no existing record governs a consequential
+  choice.
+- **Update** an existing proposal, or add evidence/outcomes/corrections that do
+  not rewrite an accepted decision's historical meaning.
+- **Supersede** when an accepted choice must change: propose a replacement,
+  preserve the old record, and link both directions after human approval.
+- **Reference** the governing ADR when work implements an existing decision;
+  do not create a duplicate.
+- Use **`ADR not required`** with one short reason for routine, local, reversible
+  work that follows accepted design.
+
+| Area | ADR required | ADR not required |
+| --- | --- | --- |
+| Dependencies | Adopt/remove a durable framework or make a compatibility-changing major upgrade | Apply a compatible patch within accepted dependency policy |
+| Public contracts | Change API, CLI, schema, compatibility, or migration semantics | Clarify documentation or tests without changing the contract |
+| Security | Change a trust boundary, authorization model, encryption, or secret handling | Implement or test an already accepted control |
+| Data models | Change durable identity, persistence, or migration strategy | Refactor a transient local representation |
+| Deployment | Change topology, hosting platform, release channel, or dependency direction | Tune retries or resources within the accepted topology |
+| Reversible details | A trigger above still makes the choice consequential | Change a local algorithm, refactor, formatting, or test organization |
+
+When stable identifiers exist, connect the work with Git trailers or equivalent
+pull-request fields:
+
+```text
+Roadmap-Step: AET-Q07
+ADR-Ref: egohygiene/hygiene#ADR-002
+```
+
+Use a local stable ID or a fully qualified `<owner>/<repository>#<id>`; always
+qualify cross-repository references. Do not invent missing IDs or evidence.
+
+This draft module inherits the proposed
+[Hygiene ADR policy v1.0.0](https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/decisions/POLICY.md)
+and
+[Repository Intelligence v1.0.0-alpha.1](https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/ecosystem/REPOSITORY_INTELLIGENCE.md)
+at immutable revision `5e0602265b6ac5e5165b89f418e55a3fd12f8a64`.
+It grants no acceptance, implementation, or organization-wide authority while
+those upstream contracts remain proposed.
+<!-- END AETHER DECISION-IMPACT -->
diff --git a/dist/github/organization/agents/auditor.agent.md b/dist/github/organization/agents/auditor.agent.md
@@ -6,6 +6,7 @@ tools:
 - read
 - search
 ---
+<!-- aether-projection {"generator":"library/organization/projections/build-projections.py","instruction_modules":[{"id":"decision-impact","inherits":[{"contract":"egohygiene.architecture-decision/v1","policy_version":"1.0.0","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/decisions/POLICY.md","status":"proposed"},{"contract":"egohygiene.repository-intelligence/v1","contract_version":"1.0.0-alpha.1","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/ecosystem/REPOSITORY_INTELLIGENCE.md","status":"proposed"}],"source":"library/organization/projections/templates/decision-impact.AGENTS.md","source_digest":{"algorithm":"sha256-utf8-lf","value":"6359706b207cc15bffa7fdbdcf093d528142b0c7675bc24dfc27534f7b015280"},"status":"draft","version":"0.1.0"}],"interface":"aether.projection-interface/v1","interface_version":"1.1.0","provider":"github-copilot","source":"library/organization/agents/auditor/AGENT.md","source_digest":{"algorithm":"sha256-utf8-lf","value":"1aeb762d0868b22dd3cce228cdd63fb74d7c587f89419cb0c4067fb25ee3859b"}} -->
 
 ## Mission
 
@@ -37,3 +38,53 @@ Apply the [`audit-repository`](.agents/skills/audit-repository/SKILL.md) skill a
 ## Completion
 
 Finish only when the report exists, follows the specification, cites evidence, documents scope and uncertainty, and records all commands or checks relied upon.
+
+<!-- BEGIN AETHER DECISION-IMPACT -->
+<!-- aether-instruction {"id":"decision-impact","inherits":[{"contract":"egohygiene.architecture-decision/v1","policy_version":"1.0.0","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/decisions/POLICY.md","status":"proposed"},{"contract":"egohygiene.repository-intelligence/v1","contract_version":"1.0.0-alpha.1","revision":"5e0602265b6ac5e5165b89f418e55a3fd12f8a64","source_url":"https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/ecosystem/REPOSITORY_INTELLIGENCE.md","status":"proposed"}],"status":"draft","version":"0.1.0"} -->
+## Decision-impact checkpoint
+
+Before changing code, inspect the applicable repository instructions, roadmap,
+local decisions, and relevant organization decisions. Classify the work as
+`create`, `update`, `supersede`, `reference`, or `ADR not required`. Do not
+silently make a consequential or ambiguous choice: surface it and request human
+review. Automated agents never mark an ADR accepted.
+
+- **Create** a proposed ADR when no existing record governs a consequential
+  choice.
+- **Update** an existing proposal, or add evidence/outcomes/corrections that do
+  not rewrite an accepted decision's historical meaning.
+- **Supersede** when an accepted choice must change: propose a replacement,
+  preserve the old record, and link both directions after human approval.
+- **Reference** the governing ADR when work implements an existing decision;
+  do not create a duplicate.
+- Use **`ADR not required`** with one short reason for routine, local, reversible
+  work that follows accepted design.
+
+| Area | ADR required | ADR not required |
+| --- | --- | --- |
+| Dependencies | Adopt/remove a durable framework or make a compatibility-changing major upgrade | Apply a compatible patch within accepted dependency policy |
+| Public contracts | Change API, CLI, schema, compatibility, or migration semantics | Clarify documentation or tests without changing the contract |
+| Security | Change a trust boundary, authorization model, encryption, or secret handling | Implement or test an already accepted control |
+| Data models | Change durable identity, persistence, or migration strategy | Refactor a transient local representation |
+| Deployment | Change topology, hosting platform, release channel, or dependency direction | Tune retries or resources within the accepted topology |
+| Reversible details | A trigger above still makes the choice consequential | Change a local algorithm, refactor, formatting, or test organization |
+
+When stable identifiers exist, connect the work with Git trailers or equivalent
+pull-request fields:
+
+```text
+Roadmap-Step: AET-Q07
+ADR-Ref: egohygiene/hygiene#ADR-002
+```
+
+Use a local stable ID or a fully qualified `<owner>/<repository>#<id>`; always
+qualify cross-repository references. Do not invent missing IDs or evidence.
+
+This draft module inherits the proposed
+[Hygiene ADR policy v1.0.0](https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/decisions/POLICY.md)
+and
+[Repository Intelligence v1.0.0-alpha.1](https://github.com/egohygiene/hygiene/blob/5e0602265b6ac5e5165b89f418e55a3fd12f8a64/docs/ecosystem/REPOSITORY_INTELLIGENCE.md)
+at immutable revision `5e0602265b6ac5e5165b89f418e55a3fd12f8a64`.
+It grants no acceptance, implementation, or organization-wide authority while
+those upstream contracts remain proposed.
+<!-- END AETHER DECISION-IMPACT -->