legrab · legrab · Aug 8, 2026 · Aug 8, 2026 · Aug 8, 2026
@@ -21,3 +21,6 @@ Desktop.ini
 # Locally generated distribution archives
 /INITIALIZE_LEARNING_FLOW_*.zip
 /codebase-learning-flow*.zip
+
+# Python script cache
+/scripts/__pycache__
@@ -17,6 +17,23 @@
 - Full-profile skills now validate machine-generated work and surface operational or human control boundaries in proportion to risk.
 - Human-facing documentation now explains the framework before agentic implementation detail.
 
+## 0.8.0
+
+### Added
+
+- A common `structured-change` skill that elaborates `Decide` into `Explore → Design → Approve` for one architecturally significant, ambiguous, or regulated change, available with every profile and running alongside the active route rather than replacing it.
+- `agentic-flow/DECISIONS.md`, a durable, append-only decision-record surface, treated like `SETTINGS.md` and written to only through `structured-change`'s Capture Knowledge step.
+- An optional `Traceability` section (and regulatory addendum) for commit bodies, documented in `agentic-flow/WORKFLOW.md`, used only for a consequential or regulated change.
+- Seven general-purpose engineering knowledge files inside `structured-change` (AI collaboration and anti-overengineering guidance, modernization, maintainability, testing, architecture, dependency management, documentation).
+- A new orthogonal, additive installer dimension, extensions (`--extension none|regulatory`, `-Extension None|Regulatory`), alongside the existing profile dimension, with a full add/update/remove lifecycle in `install.sh` and `install.ps1` and its own manifest markers so it never collides with profile bookkeeping.
+- A `regulatory` extension: the `regulatory-knowledge` skill, providing traceability, validation, risk-management, audit-trail, and change-control guidance plus short orientation to ISO 9001, ISO 13485, ISO 14971, ISO 17025, IEC 62304, and 21 CFR Part 11, and `learning-flow/REGULATORY.md`.
+- `docs/references/REFERENCE_REVIEW_LEARNING_FLOW_ADJUSTMENT.md`, documenting a user-requested comprehensive integration and the deliberate exception to the default small-delta review posture.
+
+### Changed
+
+- `agentic-flow/AGENTS.md`, `WORKFLOW.md`, `CONFIGURE.md`, `EDUCATION.md`, and `ROOT_INTEGRATION.md` gained short pointers to `structured-change`, `DECISIONS.md`, and the regulatory extension without changing default behavior for ordinary work.
+- The installer's final summary line and both profile `AGENTS.md` files now note the selected extension and how `structured-change` pairs with the active route.
+
 ## 0.7.0
 
 ### Added

@@ -1,34 +1,65 @@
 .gitattributes	40
-.gitignore	274
+.gitignore	317
 AGENTS.md	3172
-CHANGELOG.md	11414
-docs/DESIGN_NOTES.md	17684
-docs/INITIALIZE_LEARNING_FLOW.md	9396
-docs/README.md	2325
+CHANGELOG.md	13500
+docs/DESIGN_NOTES.md	22495
+docs/EDUCATION_MODEL.md	5452
+docs/INITIALIZE_LEARNING_FLOW.md	10880
+docs/README.md	2428
 docs/references/REFERENCE_INTEGRATION.md	4551
 docs/references/REFERENCE_REVIEW_AWESOME_AGENT_SKILLS.md	2317
 docs/references/REFERENCE_REVIEW_BEST_OF_AGENT_HARNESSES.md	2540
 docs/references/REFERENCE_REVIEW_GOOSE.md	2486
+docs/references/REFERENCE_REVIEW_LEARNING_FLOW_ADJUSTMENT.md	9505
 docs/references/REFERENCE_REVIEW_LITT.md	2069
 docs/references/REFERENCE_REVIEW_POCOK.md	2155
 LICENSE	2213
-README.md	8940
+README.md	10942
 sample/common/.agents/skills/agentic-workflow/SKILL.md	3653
 sample/common/.agents/skills/learn-anything/agents/openai.yaml	246
 sample/common/.agents/skills/learn-anything/SKILL.md	3225
+sample/common/.agents/skills/structured-change/knowledge/engineering/ai-collaboration.md	2533
+sample/common/.agents/skills/structured-change/knowledge/engineering/architecture.md	1386
+sample/common/.agents/skills/structured-change/knowledge/engineering/dependency-management.md	1300
+sample/common/.agents/skills/structured-change/knowledge/engineering/documentation.md	1334
+sample/common/.agents/skills/structured-change/knowledge/engineering/maintainability.md	1319
+sample/common/.agents/skills/structured-change/knowledge/engineering/modernization.md	1254
+sample/common/.agents/skills/structured-change/knowledge/engineering/testing.md	1287
+sample/common/.agents/skills/structured-change/SKILL.md	4136
+sample/common/.agents/skills/structured-change/templates/design.md	649
+sample/common/.agents/skills/structured-change/templates/exploration.md	368
 sample/common/agentic-flow/.managed-files	170
-sample/common/agentic-flow/.managed-skills	32
+sample/common/agentic-flow/.managed-skills	50
 sample/common/agentic-flow/.template-version	6
-sample/common/agentic-flow/AGENTS.md	5253
-sample/common/agentic-flow/CONFIGURE.md	4051
+sample/common/agentic-flow/AGENTS.md	5788
+sample/common/agentic-flow/CONFIGURE.md	4475
+sample/common/agentic-flow/DECISIONS.md	963
+sample/common/agentic-flow/EDUCATION.md	5232
 sample/common/agentic-flow/LEARN.md	1822
 sample/common/agentic-flow/LOCAL.md	3513
 sample/common/agentic-flow/README.md	1624
 sample/common/agentic-flow/REFERENCE_INTEGRATION.md	2183
-sample/common/agentic-flow/ROOT_INTEGRATION.md	2932
+sample/common/agentic-flow/ROOT_INTEGRATION.md	3086
 sample/common/agentic-flow/SETTINGS.md	544
-sample/common/agentic-flow/WORKFLOW.md	3309
+sample/common/agentic-flow/WORKFLOW.md	4674
 sample/common/local/learning-history.md	986
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/audit-trails.md	1444
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/cfr-part-11-overview.md	2336
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/change-control.md	1447
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/foundations.md	1997
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/iec-62304-overview.md	2341
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/iso-13485-overview.md	1804
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/iso-14971-overview.md	1901
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/iso-17025-overview.md	1724
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/iso-9001-overview.md	1493
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/risk-management.md	1873
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/traceability.md	1871
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regulatory/validation.md	1609
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/SKILL.md	3530
+sample/extensions/regulatory/learning-flow/.extension-managed-files	81
+sample/extensions/regulatory/learning-flow/.extension-managed-skills	21
+sample/extensions/regulatory/learning-flow/.extension-name	11
+sample/extensions/regulatory/learning-flow/REGULATORY.md	1719
 sample/profiles/full/.agents/skills/analogous-feature/SKILL.md	1408
 sample/profiles/full/.agents/skills/challenge-debugging/SKILL.md	1426
 sample/profiles/full/.agents/skills/challenge-debugging/templates/challenge.md	428
@@ -43,7 +74,7 @@ sample/profiles/full/learning-flow/.managed-files	137
 sample/profiles/full/learning-flow/.managed-skills	132
 sample/profiles/full/learning-flow/.template-profile	5
 sample/profiles/full/learning-flow/.template-version	6
-sample/profiles/full/learning-flow/AGENTS.md	4274
+sample/profiles/full/learning-flow/AGENTS.md	4458
 sample/profiles/full/learning-flow/BOOTSTRAP.md	1788
 sample/profiles/full/learning-flow/MAP.md	1464
 sample/profiles/full/learning-flow/PLAYBOOKS.md	1327
@@ -56,19 +87,20 @@ sample/profiles/minimal/learning-flow/.managed-files	87
 sample/profiles/minimal/learning-flow/.managed-skills	20
 sample/profiles/minimal/learning-flow/.template-profile	8
 sample/profiles/minimal/learning-flow/.template-version	6
-sample/profiles/minimal/learning-flow/AGENTS.md	2905
+sample/profiles/minimal/learning-flow/AGENTS.md	3064
 sample/profiles/minimal/learning-flow/MAP.md	1229
 sample/profiles/minimal/learning-flow/README.md	1974
 sample/profiles/minimal/learning-flow/TAKEAWAYS.md	973
-sample/README.md	2113
+sample/README.md	2997
 sample/root/AGENTS.md	1339
 sample/root/AGENTS.pointer.md	296
 scripts/install.bat	1477
-scripts/install.ps1	29480
-scripts/install.sh	24986
-scripts/README.md	3579
+scripts/install.ps1	35102
+scripts/install.sh	29472
+scripts/README.md	4502
 skill-evals/agentic-cases.yaml	7109
 skill-evals/conversation-cases.yaml	3653
 skill-evals/full-cases.yaml	4248
 skill-evals/minimal-cases.yaml	3208
-skill-evals/README.md	1110
+skill-evals/README.md	1352
+skill-evals/structured-change-cases.yaml	3735
@@ -70,6 +70,7 @@ Remote piping executes the referenced revision. Pin a release tag or commit for
 | understand or change the current repository | repository learning | the real engineering task |
 | learn a general topic | `learn-anything` | the learner's question |
 | configure or review the harness | `agentic-workflow` | repository collaboration policy |
+| sequence one consequential, ambiguous, or regulated change | `structured-change` | the active route above, not a replacement for it |
 
 For a general topic:
 
@@ -121,7 +122,7 @@ The framework is repository-agnostic, but it asks deeper questions when work tou
 
 - laboratory software;
 - industrial control and physical equipment;
-- regulated or safety-relevant software;
+- regulated or safety-relevant software (see the `regulatory` extension for the operational lens);
 - security and access control;
 - architecture and integration;
 - verification and validation;
@@ -166,6 +167,30 @@ flowchart LR
     G --> P3[General conversational learning]
 ```
 
+## Extensions
+
+Extensions are additive and orthogonal to profile: they add capability without changing what `minimal` or `full` mean. The only extension today is `regulatory`.
+
+| Extension | Adds | Never does |
+|---|---|---|
+| `regulatory` | `regulatory-knowledge` skill: traceability, validation, risk management, audit trails, change control, and short orientation to ISO 9001, ISO 13485, ISO 14971, ISO 17025, IEC 62304, and 21 CFR Part 11 | turn ordinary low-risk work into a compliance procedure |
+
+```sh
+./scripts/install.sh --profile full --extension regulatory
+```
+
+```powershell
+./scripts/install.ps1 -Profile Full -Extension Regulatory
+```
+
+`--extension auto` (the default) keeps whatever is currently installed and defaults a fresh install to none. Removing an installed extension needs `update` or `replace` mode, the same restriction that applies to a destructive profile switch:
+
+```sh
+./scripts/install.sh --mode update --extension none
+```
+
+The Explore → Design → Approve → Implement → Review → Capture Knowledge sequence this extension plugs into is not extension-specific. It lives in `structured-change`, a common skill available with every profile, and elaborates one part of `agentic-flow/WORKFLOW.md`'s `Decide` step for the rare change that is architecturally significant, genuinely ambiguous, or regulated. The `regulatory` extension adds a lens to that same skill; it does not add a second workflow.
+
 ## Private continuity
 
 > [!NOTE]
@@ -191,9 +216,11 @@ Framework modes:
 
 - `fail`: stop when managed content already exists;
 - `merge`: add missing files and preserve existing content;
-- `update`: refresh framework-owned files and skills while preserving settings, maps, takeaways, `.local/`, repository-authored content, and unrelated skills;
+- `update`: refresh framework-owned files and skills while preserving settings, decisions, maps, takeaways, `.local/`, repository-authored content, and unrelated skills;
 - `replace`: replace framework directories and this framework's managed skills.
 
+Extensions follow the same modes: `--extension regulatory` adds it, `--extension none` in `update` or `replace` removes it, and `merge` never removes an installed extension.
+
 A minimal installation can upgrade safely:
 
 ```sh
@@ -226,14 +253,18 @@ agentic-flow/
 ├── WORKFLOW.md
 ├── EDUCATION.md
 ├── LEARN.md
-└── LOCAL.md
+├── LOCAL.md
+└── DECISIONS.md
 learning-flow/
 ├── AGENTS.md
 ├── MAP.md
-└── TAKEAWAYS.md
+├── TAKEAWAYS.md
+└── REGULATORY.md         (only with --extension regulatory)
 .agents/skills/
 ├── agentic-workflow/
 ├── learn-anything/
+├── structured-change/
+├── regulatory-knowledge/ (only with --extension regulatory)
 └── profile-specific learning skills
 ```
 

@@ -105,6 +105,27 @@ Private learning continuity follows the same ownership rule in the source reposi
 
 At session closure, the local record is completed before promotion is considered. `MAP.md`, `TAKEAWAYS.md`, and existing shared owners receive only stable, reusable, non-sensitive knowledge after deduplication. An explicit request for global preservation triggers that review but does not override privacy or evidence requirements. Uncertain material stays local.
 
+## v0.8.0 regulatory-aware structured change
+
+A user-supplied proposal ("Repository Enhancement Proposal: Regulatory-Aware, Human-Guided, Agent-Assisted Engineering Flow") asked for comprehensive incorporation rather than the conservative small-delta review this document otherwise recommends (see v0.6.1). That is a deliberate, explicit exception to the default review posture, not a change to the posture itself; `docs/references/REFERENCE_REVIEW_LEARNING_FLOW_ADJUSTMENT.md` records the full mapping from source concept to landing point, including what was fitted into existing ownership rather than added as a new layer.
+
+The source's `Learn → Explore → Design → Approve → Implement → Review → Capture Knowledge` sequence did not become a competing workflow. It became `structured-change`, a common skill that elaborates the existing `Decide` step in `agentic-flow/WORKFLOW.md` for one architecturally significant, genuinely ambiguous, or regulated change, used alongside the active route rather than instead of it. Most tasks never load it.
+
+The source's `profiles: default, regulatory` concept collided with this repository's existing use of "profile" for `minimal`/`full`. It became **extensions**, a new orthogonal installer dimension (`--extension none|regulatory`), matching the source's own "Installation Extensions" heading and staying additive: `regulatory` installs identically under either profile and never changes what `minimal` or `full` mean.
+
+The source's proposed `explorations/`, `designs/`, `reviews/`, `decisions/`, `improvements/`, `integrations/`, `evaluation/` directory scaffold was not created literally; it would have reintroduced the default-folder and activity-proliferation ceremony this document has repeatedly rejected (v0.6.2, Deliberately rejected). Instead:
+
+- decision records landed in one durable file, `agentic-flow/DECISIONS.md`, treated like `SETTINGS.md` (present, never force-refreshed);
+- the commit traceability block and its regulatory addendum became an optional section of the existing commit-body guidance in `agentic-flow/WORKFLOW.md`, used only for a consequential or regulated change;
+- improvement and modernization candidates fold into the existing handoff `Open` bullet or into `DECISIONS.md`, not a separate tracking surface;
+- the evaluation matrix and confidence-reporting concepts became optional structure inside a design note, not a standing scoring system;
+- the MCP integration model became one sentence in `ROOT_INTEGRATION.md`'s existing discovery list, since connected-systems awareness was already the job of that step;
+- the human-first documentation standard and collapsible-content guidance were already covered by the existing layered-disclosure contract (v0.5.2) and required no change.
+
+Regulatory-specific knowledge (traceability, validation, risk management, audit trails, change control, and short orientation to ISO 9001, ISO 13485, ISO 14971, ISO 17025, IEC 62304, and 21 CFR Part 11) lives inside the `regulatory-knowledge` skill installed only by the extension, read a file at a time rather than loaded in bulk. IEC 62304 and 21 CFR Part 11 were added beyond the source proposal as the direct software-lifecycle and electronic-records companions to ISO 13485 and ISO 14971. Content is written as practical orientation, not standard summary or reproduction, consistent with both the source's own knowledge philosophy and this project's copyright discipline.
+
+Engineering judgment content the source proposed (anti-overengineering guidance, AI-collaboration indicators, modernization, maintainability, testing, architecture, dependency management, documentation) is general-purpose, not regulatory-specific, and lives inside `structured-change`'s own knowledge folder instead.
+
 ## General agentic loop
 
 ```text
@@ -172,7 +193,7 @@ Conversation is the live interaction layer. `.local/` is the private continuity
 
 ## Skill routing
 
-The common `agentic-workflow` skill initializes, configures, explains, or reviews the workflow. It is not loaded as a second engineering procedure during an ordinary task. The separate common `learn-anything` skill owns general learning conversations and does not inspect the repository by default.
+The common `agentic-workflow` skill initializes, configures, explains, or reviews the workflow. It is not loaded as a second engineering procedure during an ordinary task. The separate common `learn-anything` skill owns general learning conversations and does not inspect the repository by default. The common `structured-change` skill elaborates `Decide` for one consequential, ambiguous, or regulated change; it runs alongside the active route, not instead of it, and most tasks never touch it. The `regulatory` extension's `regulatory-knowledge` skill is reference material `structured-change` and task skills consult, not a workflow of its own.
 
 The full learning profile keeps seven narrow repository skills for progressive disclosure, but one skill owns the current task. The minimal profile uses one `repository-learning` skill with compact branches for bug, feature, refactor, and orientation work. Both add the common generic conversation skill without changing their repository-learning profile.
 
@@ -188,6 +209,8 @@ The common layer and each learning profile include managed-file and managed-skil
 
 Minimal-to-full update is supported. Full-to-minimal update is rejected because safe automatic deletion cannot be inferred.
 
+Extensions (currently only `regulatory`) use the same three modes along a dimension orthogonal to profile: they track their own managed-file and managed-skill manifests under distinct marker names so they never collide with the profile's own markers, and adding or removing one never touches the other's files.
+
 ## Deliberately rejected
 
 - mandatory configuration before routine work;
@@ -200,7 +223,9 @@ Minimal-to-full update is supported. Full-to-minimal update is rejected because
 - generic skills for token efficiency or determinism;
 - generic learning that silently inspects or writes into the host repository;
 - committed personal transcripts and hypothesis diaries;
-- a dashboard, database, vector store, orchestration service, or LMS.
+- a dashboard, database, vector store, orchestration service, or LMS;
+- a proliferating `explorations/`/`designs/`/`decisions/`-per-item directory scaffold in place of the existing durable-file surfaces;
+- mandatory evaluation-matrix scoring or commit traceability blocks for ordinary, low-risk work.
 
 ## Final review checklist
 
@@ -216,3 +241,4 @@ Minimal-to-full update is supported. Full-to-minimal update is rejected because
 10. Update preserves repository-authored settings and knowledge.
 11. The Markdown fallback works without skill support.
 12. No workflow requires contributor identity unless the user explicitly wants personal tracking.
+13. An installed extension never changes what a profile means, and adding or removing one never touches unrelated framework or repository content.