legrab · legrab · Aug 10, 2026 · Aug 10, 2026
@@ -2,10 +2,31 @@
 
 ## Unreleased
 
+Architectural simplification of the `full` profile: reduced meta-ceremony while preserving every behavior the framework depends on (repository authority, selective learning, hypothesis-first proposals, consequential-change reasoning, private continuity, optional regulatory guidance).
+
 ### Added
 
+- `full` profile `repository-learning` skill: one skill covering orientation, bug, feature, and refactor branches, matching the shape the minimal profile already used. Carries all the depth of the four skills it replaces (ownership-compass questions, per-branch report shape, optional `challenge.md` template).
+- "Making reasoning explicit" section in `agentic-flow/WORKFLOW.md`, replacing `ARTIFACTS.md` with just the one artifact type (the compact current-understanding model) that had independent operational value.
+- "Branches" fallback table inline in `full/learning-flow/AGENTS.md`, for agents without task-skill support, replacing `PLAYBOOKS.md`.
+- Collapsible "Check techniques and handling" section under `full/learning-flow/AGENTS.md`'s "Understanding checks" heading, replacing `UNDERSTANDING_CHECKS.md`.
+- Explicit reference to `structured-change`'s own `knowledge/engineering/` folder from its Design step; the folder previously existed but was never read by the skill that owns it.
+- "Runtime instruction flow" diagram in `docs/ARCHITECTURE.md` showing the actual per-task instruction path end to end.
+
+### Removed
+
+- `agentic-flow/ARTIFACTS.md` (six of its eight artifact types restated concepts already owned by `structured-change`, `WORKFLOW.md`, or `learning-closure`).
+- `full/learning-flow/BOOTSTRAP.md` (duplicated the `learning-bootstrap` skill's procedure almost verbatim; the skill is now the sole owner).
+- `full/learning-flow/PLAYBOOKS.md` (duplicated four skills' branch logic; content now lives inline in `AGENTS.md`).
+- `full/learning-flow/UNDERSTANDING_CHECKS.md` (restated a rule already stated in four other files).
+- `full` profile skills `repository-orientation`, `challenge-debugging`, `analogous-feature`, `safe-refactor` (merged into `repository-learning`).
+
 ### Changed
 
+- Deduplicated the external-source provenance field list between `learning-closure` and `learning-freshness`; `learning-closure` is now the single owner.
+- `full/learning-flow/README.md` diagram and "Understanding and assessment" section updated to match the reduced skill count and single canonical rule.
+- `ticket-learning-path`'s implementation-handoff step now names `repository-learning` instead of the three merged skills.
+
 ## 1.1.0
 
 Finalized the post-1.0 learning and reasoning improvements for the 1.1.0 release.

@@ -1,10 +1,14 @@
 .gitattributes	40
 .gitignore	324
 AGENTS.md	2995
-CHANGELOG.md	21735
+CHANGELOG.md	24247
+LICENSE	2213
+README.md	8952
+adoption/ADOPT.md	4177
+adoption/README.md	2057
 docs/AGENTIC_WORKFLOW_SANITY.md	9207
-docs/ARCHITECTURE.md	5689
-docs/DESIGN_NOTES.md	31204
+docs/ARCHITECTURE.md	7131
+docs/DESIGN_NOTES.md	35837
 docs/EDUCATION_MODEL.md	5452
 docs/INITIALIZE_LEARNING_FLOW.md	10880
 docs/README.md	4016
@@ -15,38 +19,39 @@ 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	8888
+sample/README.md	2997
 sample/common/.agents/skills/agentic-workflow/SKILL.md	2686
-sample/common/.agents/skills/learn-anything/agents/openai.yaml	246
 sample/common/.agents/skills/learn-anything/SKILL.md	1756
+sample/common/.agents/skills/learn-anything/agents/openai.yaml	246
+sample/common/.agents/skills/learning-closure/SKILL.md	3605
+sample/common/.agents/skills/learning-freshness/SKILL.md	1908
+sample/common/.agents/skills/structured-change/SKILL.md	3059
 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	2770
 sample/common/.agents/skills/structured-change/templates/design.md	649
 sample/common/.agents/skills/structured-change/templates/exploration.md	368
 sample/common/.agents/skills/structured-change/templates/structure.md	243
-sample/common/agentic-flow/.managed-files	183
+sample/common/agentic-flow/.managed-files	170
 sample/common/agentic-flow/.managed-skills	86
 sample/common/agentic-flow/.template-version	6
-sample/common/agentic-flow/AGENTS.md	5961
-sample/common/agentic-flow/ARTIFACTS.md	2605
+sample/common/agentic-flow/AGENTS.md	5995
 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	4179
-sample/common/agentic-flow/README.md	2969
+sample/common/agentic-flow/README.md	2897
 sample/common/agentic-flow/REFERENCE_INTEGRATION.md	2183
 sample/common/agentic-flow/ROOT_INTEGRATION.md	3086
 sample/common/agentic-flow/SETTINGS.md	544
-sample/common/agentic-flow/WORKFLOW.md	5020
+sample/common/agentic-flow/WORKFLOW.md	6059
 sample/common/local/learning-history.md	1528
+sample/extensions/regulatory/.agents/skills/regulatory-knowledge/SKILL.md	3530
 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
@@ -59,33 +64,24 @@ sample/extensions/regulatory/.agents/skills/regulatory-knowledge/knowledge/regul
 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	1882
-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	511
 sample/profiles/full/.agents/skills/change-explainer/SKILL.md	1308
 sample/profiles/full/.agents/skills/change-explainer/templates/change-explainer.md	353
-sample/profiles/full/.agents/skills/learning-bootstrap/SKILL.md	1522
-sample/profiles/full/.agents/skills/repository-orientation/SKILL.md	1222
-sample/profiles/full/.agents/skills/safe-refactor/SKILL.md	1373
-sample/profiles/full/.agents/skills/ticket-learning-path/SKILL.md	1519
+sample/profiles/full/.agents/skills/learning-bootstrap/SKILL.md	1491
+sample/profiles/full/.agents/skills/ticket-learning-path/SKILL.md	1513
 sample/profiles/full/.agents/skills/ticket-learning-path/templates/ticket-learning-path.md	405
-sample/profiles/full/learning-flow/.managed-files	137
-sample/profiles/full/learning-flow/.managed-skills	132
+sample/profiles/full/learning-flow/.managed-files	87
+sample/profiles/full/learning-flow/.managed-skills	77
 sample/profiles/full/learning-flow/.template-profile	5
 sample/profiles/full/learning-flow/.template-version	6
-sample/profiles/full/learning-flow/AGENTS.md	4716
-sample/profiles/full/learning-flow/BOOTSTRAP.md	1788
+sample/profiles/full/learning-flow/AGENTS.md	6548
 sample/profiles/full/learning-flow/MAP.md	1464
-sample/profiles/full/learning-flow/PLAYBOOKS.md	1327
-sample/profiles/full/learning-flow/README.md	2574
+sample/profiles/full/learning-flow/README.md	2320
 sample/profiles/full/learning-flow/REPOSITORIES.md	439
 sample/profiles/full/learning-flow/TAKEAWAYS.md	970
-sample/profiles/full/learning-flow/UNDERSTANDING_CHECKS.md	2010
 sample/profiles/minimal/.agents/skills/repository-learning/SKILL.md	3718
 sample/profiles/minimal/learning-flow/.managed-files	87
 sample/profiles/minimal/learning-flow/.managed-skills	20
@@ -95,22 +91,17 @@ sample/profiles/minimal/learning-flow/AGENTS.md	2633
 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	2997
 sample/root/AGENTS.md	2102
 sample/root/AGENTS.pointer.md	551
+scripts/README.md	6771
 scripts/install.bat	1477
 scripts/install.ps1	40236
 scripts/install.sh	34910
-scripts/README.md	6771
+skill-evals/README.md	1667
+skill-evals/adoption-cases.yaml	1337
 skill-evals/agentic-cases.yaml	8895
 skill-evals/conversation-cases.yaml	3653
-skill-evals/full-cases.yaml	4640
+skill-evals/full-cases.yaml	4648
+skill-evals/learning-lifecycle-cases.yaml	1599
 skill-evals/minimal-cases.yaml	3655
-skill-evals/README.md	1667
 skill-evals/structured-change-cases.yaml	4710
-adoption/ADOPT.md	4177
-adoption/README.md	2057
-sample/common/.agents/skills/learning-closure/SKILL.md	3605
-sample/common/.agents/skills/learning-freshness/SKILL.md	1904
-skill-evals/learning-lifecycle-cases.yaml	1599
-skill-evals/adoption-cases.yaml	1337
@@ -164,7 +164,7 @@ When relevant:
 | Profile | Learning surface |
 |---|---|
 | `minimal` | one compact repository-learning skill |
-| `full` | focused orientation, debugging, feature, refactor, and explanation skills |
+| `full` | deeper `repository-learning` skill (orientation, debugging, feature, refactor), plus baseline, ticket-path, and change-explanation skills |
 
 Both use the same common educational constitution and agentic layer.
 

@@ -116,6 +116,31 @@ This separation is a trust and context boundary as well as an installation bound
 
 </details>
 
+## Runtime instruction flow
+
+The path an agent actually walks for one task, independent of profile:
+
+```mermaid
+flowchart TD
+    Root[Repository-native instructions] --> AF[agentic-flow/AGENTS.md]
+    AF --> Route{Task needs repository<br/>learning support?}
+    Route -->|no| WF[WORKFLOW.md loop]
+    Route -->|yes| LF[learning-flow/AGENTS.md]
+    Route -->|general topic, no repo| LA[learn-anything]
+    LF --> Skill[One learning skill:<br/>bootstrap / repository-learning branch /<br/>change-explainer / ticket-learning-path]
+    Skill --> WF
+    WF --> Sig{Consequential, ambiguous,<br/>or regulated?}
+    Sig -->|yes| SC["structured-change<br/>(+ regulatory-knowledge if installed)"]
+    Sig -->|no| Act[Act → Verify]
+    SC --> Act
+    Act --> HO[Handoff]
+    HO --> Reuse{Reusable insight?}
+    Reuse -->|yes| LC[learning-closure →<br/>LOCAL.md / MAP.md / TAKEAWAYS.md]
+    Reuse -->|no| Done[Done]
+```
+
+Every box is read only when its condition is met; `EDUCATION.md` is applied selectively inside whichever learning skill runs, not as a separate stop. A maintainer auditing "what does an installed `full` profile actually load for a bug fix" reads this diagram top to bottom: `AGENTS.md` → `learning-flow/AGENTS.md` → `repository-learning` (Bug branch) → `WORKFLOW.md` → optionally `structured-change` → handoff → optionally `learning-closure`. No other file sits on that path unless the task specifically needs it.
+
 ## Learning lifecycle
 
 Learning is treated as a lifecycle rather than a second engineering process:

@@ -158,6 +158,22 @@ The rest of the pass fit the same "one canonical owner" discipline as everything
 
 A larger set of proposed improvements (lightweight learning artifacts, incremental learning rounds, an explicit inspectable system model, a structure step between design and planning, branching alternative designs) was reviewed and deliberately deferred rather than folded in. Each would require real design and evaluation work to avoid becoming ceremony, which is exactly what this document's "smallest coherent hardening pass" standard rules out for a single pass; the reasoning and file-level implementation detail for each lives in the post-1.0 backlog document delivered alongside this release, not inside this repository, so an optional future improvement doesn't read as a committed roadmap.
 
+## v1.1 remove meta-ceremony
+
+A consumer-perspective review of an installed `full` profile found that correctness had come to depend on keeping many documents synchronized: a competent developer had to discover and cross-reference more instruction surfaces than the underlying engineering task justified. Five duplications accounted for most of the cost, each fixed by giving the behavior exactly one owner instead of shortening the copies:
+
+- `agentic-flow/ARTIFACTS.md` named eight "artifact types," six of which restated concepts `structured-change`, `WORKFLOW.md`, or `learning-closure` already owned, and its correction-propagation guidance only pointed at `LOCAL.md` anyway. The one artifact type with real, undocumented-elsewhere behavior — the compact current-understanding `model` — moved into a "Making reasoning explicit" section in `agentic-flow/WORKFLOW.md`. The file was removed.
+- `full/learning-flow/BOOTSTRAP.md` and the `learning-bootstrap` skill contained the same nine-step procedure almost verbatim. The root-level file was removed; the skill is now the single, self-contained owner.
+- `full/learning-flow/PLAYBOOKS.md` existed only as a fallback for agents without task-skill support, and duplicated the branch logic of four separate skills in table form. That fallback content now lives inline in `full/learning-flow/AGENTS.md` under "Branches" — the file every setup reads regardless of skill support — so the separate file added a synchronization cost without adding reach. It was removed.
+- `full/learning-flow/UNDERSTANDING_CHECKS.md` restated a rule ("ask at most one check; confidence is not proof") already stated in `EDUCATION.md`, `agentic-flow/AGENTS.md`, `full/learning-flow/AGENTS.md`, and `full/learning-flow/README.md`. The elaboration it added beyond the rule (check techniques, when to skip, how to handle a wrong answer) moved into a collapsible section under `full/learning-flow/AGENTS.md`'s existing "Understanding checks" heading; the other three surfaces now state the rule once and point there instead of restating it.
+- `structured-change`'s own `knowledge/engineering/` folder was never referenced by its own `SKILL.md` — a genuinely orphaned surface, not a duplicated one. The Design step now names it explicitly.
+
+Separately, the full profile's seven near-identical task skills (`learning-bootstrap`, `repository-orientation`, `challenge-debugging`, `analogous-feature`, `safe-refactor`, `change-explainer`, `ticket-learning-path`) reversed the v1.0-era "progressive disclosure" framing (see "Skill routing" above, then current): `repository-orientation`, `challenge-debugging`, `analogous-feature`, and `safe-refactor` shared the same header, the same locate-reason-verify-report shape, and the same PLAYBOOKS.md table row each — the disclosure was one of file count, not of actual content boundaries. They merged into one `repository-learning` skill with four branches, matching the shape the minimal profile already used successfully for the same four concerns, with full's extra depth (the ownership-compass questions, deeper proof-by-risk requirements, and the optional `challenge.md` template) preserved inside it. `learning-bootstrap`, `change-explainer`, and `ticket-learning-path` remain separate because each has a genuinely distinct trigger moment and non-duplicated content — merging them would have hidden that distinction rather than removed real duplication.
+
+`learning-closure` and `learning-freshness` were reviewed against the same test and kept separate: each is already lean, each fires at a different point in the workflow (handoff vs. deliberate maintenance), and separate descriptions help an agent's skill matching select the right one. Only their duplicated external-source provenance field list was deduplicated, with `learning-closure` as the single owner. `LOCAL.md` and `structured-change` were reviewed and kept as-is: both are load-bearing, cross-referenced from nearly every skill, and not redundant with anything else in the repository.
+
+Net effect for a `full`-profile consumer: a typical task now touches four fewer files to discover the right procedure, and the rule "ask at most one understanding check" has one canonical statement instead of four. No behavior the framework depends on for repository-specific authority, selective learning, hypothesis-first proposals, consequential-change reasoning, private continuity, or optional regulatory guidance changed.
+
 ## General agentic loop
 
 ```text
@@ -187,7 +203,7 @@ Designed for daily use and token economy. Its shared tracked learning is limited
 
 ### Full
 
-Designed for deliberate onboarding and long-lived learning programs. It keeps only maps, takeaways, repository baselines, and task-specific learning skills tracked by default. Private sessions and contributor-specific template instances use `.local/`; promoted shared artifacts remain exceptional. Optional challenge, ticket-path, and change-explainer templates live inside their owning skills and are materialized only on explicit need.
+Designed for deliberate onboarding and long-lived learning programs. It keeps only maps, takeaways, repository baselines, and task-specific learning skills tracked by default. Private sessions and contributor-specific template instances use `.local/`; promoted shared artifacts remain exceptional. An optional challenge template lives inside `repository-learning`; ticket-path and change-explainer templates live inside their own owning skills. All are materialized only on explicit need.
 
 ## Shared learning loop
 
@@ -227,7 +243,7 @@ Conversation is the live interaction layer. `.local/` is the private continuity
 
 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.
+The full learning profile uses one deeper `repository-learning` skill covering four branches (orientation, bug, feature, refactor) plus `learning-bootstrap`, `change-explainer`, and `ticket-learning-path` for their distinct trigger moments. The minimal profile uses the same `repository-learning` shape with compact branches and no baseline, explainer, or ticket-path skills. Both add the common generic conversation skill without changing their repository-learning profile.
 
 ## Installer lifecycle