Provide generic local flow and compact human contexts

.gitattributes

@@ -0,0 +1,3 @@
+* text=auto eol=lf
+
+*.bat text eol=crlf

.gitignore

@@ -16,6 +16,7 @@ Desktop.ini
 *.temp
 *.bak
 *.log
+/.local/
 
 # Locally generated distribution archives
 /INITIALIZE_LEARNING_FLOW_*.zip

AGENTS.md

@@ -2,12 +2,21 @@
 
 ## Purpose
 
-Maintain a small repository-native harness for safe agentic collaboration and deliberate codebase learning. Preserve the separation between:
+Maintain a small harness for safe agentic collaboration, deliberate codebase learning, and conversational learning about general topics. Preserve the separation between:
 
 - repository-specific engineering rules;
 - general collaboration behavior in `agentic-flow/`;
 - optional learning behavior in `learning-flow/`;
-- temporary task state.
+- generic conversation behavior in the common `learn-anything` skill;
+- private learning and temporary task state under `.local/`.
+
+## Generic conversational learning
+
+When the user explicitly wants to learn a non-repository topic, treat this checkout as the host rather than the subject. Stay in the conversation and follow `Locate → Reason → Work → Explain → Recap`: find the learner's question, build a compact system model from the useful parts of purpose, boundary, relationships, change or feedback, evidence, and transfer, use one helpful example or practice step, and close without repeating the answer.
+
+Do not inspect repository code for this route. For a meaningful learning session, use `.local/` as described in `sample/common/agentic-flow/LOCAL.md`: retain the complete private session and compact cross-session history there, then promote only clearly reusable framework knowledge deliberately. General programming concepts are in scope; questions about this codebase continue to use the repository-learning flow.
+
+If this source checkout has no `.local/` workspace yet, create `.local/{sessions,follow-ups}` and seed `.local/learning-history.md` from `sample/common/local/learning-history.md`. Never overwrite existing local state.
 
 ## Working rules
 

CHANGELOG.md

@@ -1,5 +1,76 @@
 # Changelog
 
+## 0.7.0
+
+### Added
+
+- A common `learn-anything` skill for friendly, adaptive learning conversations about non-repository topics.
+- Source-repository instructions and routing checks that keep general learning chat-like and send codebase questions back to repository learning.
+- An ignored repository-root `.local/` workspace for complete private learning sessions, compact cross-session history, and generated follow-up material.
+
+### Changed
+
+- The shared `Locate → Reason → Work → Explain → Recap` loop can now locate a learner's question as well as repository evidence, while retaining one selective route at a time.
+- Both profiles install the generic learning skill without adding private study records to tracked learning surfaces.
+- Session closure now saves contributor-specific state locally and promotes only stable, reusable, non-sensitive knowledge into existing shared records.
+- Installers initialize `.local/` idempotently, preserve existing history, and ensure the directory is excluded through `.gitignore`.
+- Repository and general-topic learning now share a selective system lens covering purpose, boundaries, relationships, change or feedback, evidence, and transfer.
+- First-use documentation now leads with installation and a real task, while optional modes and reference inventories use progressive disclosure.
+- Always-loaded collaboration and profile instructions now defer low-frequency detail to existing canonical guides, reducing repetition without changing behavior.
+
+## 0.6.2
+
+### Changed
+
+- Normal managed-template integration no longer requires an agentic setup status in the learning map; only durable custom exceptions or conflicts are recorded.
+- Full-profile bootstrap is now an explicitly requested onboarding activity rather than a prerequisite for the first real task.
+- Learning reinforcement is folded into the normal handoff, limited to a few useful points, and skipped when it would duplicate delivery evidence.
+
+### Removed
+
+- Baseline reporting of transient branch, commit, profile, settings, and ordinary template status.
+- Separate quota-shaped recap sections after the normal agentic handoff.
+
+## 0.6.1
+
+### Changed
+
+- Reference integrations now treat external sources as evidence rather than target architectures.
+- Reviews name useful value already covered locally and retain only a small gap-closing delta, including an explicit no-change outcome when appropriate.
+- The integration contract preserves the repository's educational core, friendly voice, and low-ceremony defaults instead of importing breadth or rigidity for parity.
+- Third-party skills now require a lightweight source, capability, and rule-overlap review; catalogue presence or popularity is not treated as endorsement.
+- The standard flow now checks only task-critical runtime, tool, access, and approval readiness before acting, then adapts or reports the exact blocker.
+- Project and installed READMEs now clarify that the flow configures a host agent rather than providing a tool runtime, sandbox, retry engine, or durable resumption.
+
+### Reference reviews
+
+- Reviewed `VoltAgent/awesome-agent-skills` at an exact revision and retained only the external-skill trust boundary.
+- Reviewed `aaif-goose/goose` at an exact revision and retained only a lightweight capability-readiness check.
+- Reviewed `RyanAlberts/best-of-Agent-Harnesses` at an exact revision and retained only a product-scope clarification.
+
+## 0.6.0
+
+### Added
+
+- Task-first onboarding that verifies the installed workflow quietly and surfaces only meaningful conflicts.
+- Sparse `Now / Found / Next` progress pulses for substantial work without command narration.
+- A compact domain slice connecting actors, outcomes, capabilities, invariants, triggers, effects, ownership, and evidence.
+- `fast`, `balanced`, `guided`, and `gated` collaboration presets with optional advanced overrides.
+
+### Changed
+
+- Initial learning records one agentic setup status instead of inventorying the framework before useful work.
+- Learning routes start from the affected domain outcome or rule before tracing implementation.
+- The full profile keeps only its durable core visible; task templates now travel inside their owning skills.
+- Root integration exposes three behaviorally distinct choices and records `linked`, `pending`, or `explicit-only` in settings.
+- Learning depth and persistence are independently configurable.
+- Update mode removes retired framework-owned files while preserving repository-authored content.
+
+### Removed
+
+- Pre-created full-profile research, material, contributor, explainer, lab, and general template directories.
+- The superseded pre-profile `sample/learning-flow/` tree.
+
 ## 0.5.3
 
 ### Added

MANIFEST.txt

@@ -1,78 +1,74 @@
-.gitignore	265
-AGENTS.md	1749
-CHANGELOG.md	5566
-docs/DESIGN_NOTES.md	10793
-docs/INITIALIZE_LEARNING_FLOW.md	7638
-docs/README.md	776
-docs/references/REFERENCE_INTEGRATION.md	3485
+.gitattributes	40
+.gitignore	274
+AGENTS.md	3010
+CHANGELOG.md	10259
+docs/DESIGN_NOTES.md	17684
+docs/INITIALIZE_LEARNING_FLOW.md	9396
+docs/README.md	1185
+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_LITT.md	2069
-docs/references/REFERENCE_REVIEW_POCOK.md	2154
+docs/references/REFERENCE_REVIEW_POCOK.md	2155
 LICENSE	2213
-README.md	6571
-sample/README.md	1328
-sample/common/.agents/skills/agentic-workflow/SKILL.md	3188
-sample/common/agentic-flow/.managed-files	148
-sample/common/agentic-flow/.managed-skills	17
+README.md	8266
+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	3606
+sample/common/agentic-flow/.managed-files	157
+sample/common/agentic-flow/.managed-skills	32
 sample/common/agentic-flow/.template-version	6
-sample/common/agentic-flow/AGENTS.md	4242
-sample/common/agentic-flow/CONFIGURE.md	3032
-sample/common/agentic-flow/LEARN.md	1690
-sample/common/agentic-flow/README.md	914
-sample/common/agentic-flow/REFERENCE_INTEGRATION.md	1683
-sample/common/agentic-flow/ROOT_INTEGRATION.md	3053
-sample/common/agentic-flow/SETTINGS.md	418
-sample/common/agentic-flow/WORKFLOW.md	2283
-sample/profiles/full/.agents/skills/analogous-feature/SKILL.md	1338
-sample/profiles/full/.agents/skills/challenge-debugging/SKILL.md	1269
-sample/profiles/full/.agents/skills/change-explainer/SKILL.md	1254
-sample/profiles/full/.agents/skills/learning-bootstrap/SKILL.md	1930
-sample/profiles/full/.agents/skills/repository-orientation/SKILL.md	1443
-sample/profiles/full/.agents/skills/safe-refactor/SKILL.md	1273
-sample/profiles/full/.agents/skills/ticket-learning-path/SKILL.md	1431
-sample/profiles/full/learning-flow/.managed-files	555
+sample/common/agentic-flow/AGENTS.md	5205
+sample/common/agentic-flow/CONFIGURE.md	4051
+sample/common/agentic-flow/LEARN.md	1822
+sample/common/agentic-flow/LOCAL.md	3157
+sample/common/agentic-flow/README.md	1237
+sample/common/agentic-flow/REFERENCE_INTEGRATION.md	2183
+sample/common/agentic-flow/ROOT_INTEGRATION.md	2932
+sample/common/agentic-flow/SETTINGS.md	544
+sample/common/agentic-flow/WORKFLOW.md	3309
+sample/common/local/learning-history.md	625
+sample/profiles/full/.agents/skills/analogous-feature/SKILL.md	1389
+sample/profiles/full/.agents/skills/challenge-debugging/SKILL.md	1587
+sample/profiles/full/.agents/skills/challenge-debugging/templates/challenge.md	428
+sample/profiles/full/.agents/skills/change-explainer/SKILL.md	1482
+sample/profiles/full/.agents/skills/change-explainer/templates/change-explainer.md	290
+sample/profiles/full/.agents/skills/learning-bootstrap/SKILL.md	1875
+sample/profiles/full/.agents/skills/repository-orientation/SKILL.md	1547
+sample/profiles/full/.agents/skills/safe-refactor/SKILL.md	1392
+sample/profiles/full/.agents/skills/ticket-learning-path/SKILL.md	1633
+sample/profiles/full/.agents/skills/ticket-learning-path/templates/ticket-learning-path.md	348
+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	5214
-sample/profiles/full/learning-flow/BOOTSTRAP.md	2178
-sample/profiles/full/learning-flow/MAP.md	1421
-sample/profiles/full/learning-flow/PLAYBOOKS.md	1064
-sample/profiles/full/learning-flow/README.md	2904
+sample/profiles/full/learning-flow/AGENTS.md	5302
+sample/profiles/full/learning-flow/BOOTSTRAP.md	2097
+sample/profiles/full/learning-flow/MAP.md	945
+sample/profiles/full/learning-flow/PLAYBOOKS.md	1157
+sample/profiles/full/learning-flow/README.md	2991
 sample/profiles/full/learning-flow/REPOSITORIES.md	439
 sample/profiles/full/learning-flow/TAKEAWAYS.md	570
-sample/profiles/full/learning-flow/UNDERSTANDING_CHECKS.md	1580
-sample/profiles/full/learning-flow/contributors/README.md	558
-sample/profiles/full/learning-flow/explainers/README.md	385
-sample/profiles/full/learning-flow/labs/README.md	373
-sample/profiles/full/learning-flow/materials/README.md	285
-sample/profiles/full/learning-flow/materials/themes/README.md	115
-sample/profiles/full/learning-flow/research/README.md	420
-sample/profiles/full/learning-flow/research/topics/README.md	161
-sample/profiles/full/learning-flow/templates/challenge.md	423
-sample/profiles/full/learning-flow/templates/change-explainer.md	308
-sample/profiles/full/learning-flow/templates/contributor-readme.md	199
-sample/profiles/full/learning-flow/templates/contributor-theme.md	134
-sample/profiles/full/learning-flow/templates/contributor-tracking.md	155
-sample/profiles/full/learning-flow/templates/lab-readme.md	202
-sample/profiles/full/learning-flow/templates/learning-material.md	192
-sample/profiles/full/learning-flow/templates/research-topic.md	197
-sample/profiles/full/learning-flow/templates/ticket-learning-path.md	348
-sample/profiles/minimal/.agents/skills/repository-learning/SKILL.md	2789
+sample/profiles/full/learning-flow/UNDERSTANDING_CHECKS.md	1627
+sample/profiles/minimal/.agents/skills/repository-learning/SKILL.md	3258
 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	3404
-sample/profiles/minimal/learning-flow/MAP.md	1316
-sample/profiles/minimal/learning-flow/README.md	1425
+sample/profiles/minimal/learning-flow/AGENTS.md	3762
+sample/profiles/minimal/learning-flow/MAP.md	811
+sample/profiles/minimal/learning-flow/README.md	1648
 sample/profiles/minimal/learning-flow/TAKEAWAYS.md	551
-sample/root/AGENTS.md	1242
+sample/README.md	1600
+sample/root/AGENTS.md	1339
 sample/root/AGENTS.pointer.md	296
-scripts/README.md	1742
 scripts/install.bat	1434
-scripts/install.ps1	22829
-scripts/install.sh	21235
-skill-evals/README.md	695
-skill-evals/agentic-cases.yaml	3826
-skill-evals/full-cases.yaml	1867
-skill-evals/minimal-cases.yaml	1756
+scripts/install.ps1	29480
+scripts/install.sh	24986
+scripts/README.md	2660
+skill-evals/agentic-cases.yaml	6691
+skill-evals/conversation-cases.yaml	2633
+skill-evals/full-cases.yaml	2977
+skill-evals/minimal-cases.yaml	2377
+skill-evals/README.md	1002