Provide generic local flow and compact human contexts - #2
Merged
Merged
Conversation
Start from the user's real task, reduce agentic setup mapping to meaningful differences, and add sparse progress pulses for substantial work.
Connect repository learning to actors, outcomes, capabilities, invariants, triggers, effects, ownership, and evidence before tracing implementation.
Keep only the durable learning core visible, move warranted templates into their owning skills, remove the superseded sample tree, and retire obsolete managed files during updates.
Replace the setup matrix with fast, balanced, guided, and gated presets; keep advanced overrides optional, separate learning from persistence, and persist distinct root integration states.
Why External references should strengthen clear local gaps without becoming target architectures or importing their ceremony. What Make already-covered and no-change outcomes explicit, cap the normal behavioral delta, and preserve the educational voice and profile model. Checks Validate version markers, manifest sizes, installer syntax, Bash syntax, and whitespace.
Why A curated skill catalogue helps discovery, but its entries remain executable external instructions and are not security-audited. What Require lightweight source and capability review before adoption, preserve narrow single-skill routing, and record the exact VoltAgent review. Checks Validate Markdown links, manifest paths and normalized sizes, and whitespace.
Why A sound plan can still fail late when its required runtime, tools, access, or approval are unavailable. What Add one task-critical capability check to Decide, adapt or report an exact blocker, and record the exact Goose review without importing its extension or permission systems. Checks Validate Markdown links, manifest paths and normalized sizes, temporary-source cleanup, and whitespace.
Why A broad harness comparison can make a portable repository configuration look like it owns execution infrastructure that actually belongs to the host agent. What Clarify the runtime boundary in both entry READMEs and record the intentionally light Best of Agent Harnesses review without changing workflow behavior. Checks Validate managed-file coverage, Markdown links, manifest paths and normalized sizes, installer syntax, temporary-source cleanup, and whitespace.
Why Routine repository learning still paid two framework taxes: recording a normal installation in the learning map and producing a recap after the regular handoff. What Record only durable custom agentic exceptions, make full bootstrap explicitly optional, remove transient baseline reporting, and fold useful learning into one normal handoff without quotas. Checks Validate profile parity, managed files and skills, anti-ceremony regressions, Markdown links, manifest sizes, installer syntax, and whitespace.
Why - Make flow and system relationships the framework's educational core. - Preserve useful personal continuity without turning learning into tracked ceremony. What - Add conversational learn-anything guidance and the ignored .local model. - Align profiles, installers, documentation, manifests, and evaluation cases. Checks - Validate skills, YAML, Markdown links, manifests, and line endings. - Exercise minimal and full install/update preservation in PowerShell and shell.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A general revisit around the base learning flows better streamlines engagement while keeping administrative rituals out of the picture.
User-only findings have been adjusted to be local-only avoiding repository pollution while dedicated methods to promote content into the common knowledge base have been clarified.
A general migration towards skills has been applied for agentic efficiency while various documentaiton aimed at human consumption have been reduced and had their "advanced" sections moved into expandables.