feat(runneth-apps): seed customer-owned setup templates - #142
Open
ioana (ioanahayman) wants to merge 4 commits into
Open
feat(runneth-apps): seed customer-owned setup templates#142ioana (ioanahayman) wants to merge 4 commits into
ioana (ioanahayman) wants to merge 4 commits into
Conversation
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.
Summary
runneth-defaultto0.4.0with customer-owned setup templates for integrations and glossary definitions./agent/brain/integrations/with a folder explainer, reusable integration templates, and protocols for integration type, quirks, and usage-feedback capture./agent/brain/glossary/with templates for primary KPI, attribution, winner definition, ad states, naming conventions, funnel stages, voice rules, and channel roles.seed_fileresource type from the sister Agent Builder PR.Context
This is the Runneth Apps side of Phase 1.5 and is stacked on the Phase One default package PR: #141
Phase 1.5 installs the smallest useful customer-owned setup layer for the analyst use case. It seeds the place and shape for org-specific integration and glossary knowledge without pre-filling every customer brain with broad app-specific docs.
The split is intentional:
Research Grounding
The transcript, Eric integration knowledge-layer plan, Reza knowledge-layer framing, Faye-style setup references, prod conversations, and Motion's Runneth VM brain all point to the same package shape: seed editable setup structure, then create app-specific or customer-specific maps from real signal. Customers commonly customize KPI definitions, attribution windows, source-of-truth preferences, naming conventions, reporting formats, and integration usage rules, so broad pre-seeded per-app placeholders would add clutter before the agent knows what matters for that org.
The Motion VM brain audit grounded the reusable pieces in existing setup files: Faye-style integration protocols for capabilities, activation, practical guides, quirks, and usage feedback; glossary templates for KPI, attribution, winner definitions, naming conventions, funnel stages, channel roles, and voice rules; and default user-brain routing that treats these definitions as customer-owned context. Motion-specific facts, org credentials, account playbooks, and heavy onboarding/sync skills are intentionally not copied into this default package.
The seeded files are not generic API documentation. They define stable customer-owned homes for source-of-truth rules, KPI definitions, attribution windows, naming conventions, important fields/folders/channels/reports, known gotchas, and reusable glossary definitions.
Sister PR
Requires the Agent Builder package manager and prompt support for brain-only
seed_fileresources: https://github.com/Motion-Creative/agent-builder/pull/2320Validation
GITHUB_EVENT_PATH=/tmp/runneth-fleet-approved-event.json node --test scripts/validate-runneth-package-index.mjsgit diff --checkNotes
runneth-fleet-change-approvedlabel becauserunneth-defaultis auto-installable.