Establish agent skills as source of truth, simplify example content#95
Draft
pkosiec wants to merge 1 commit into
Draft
Establish agent skills as source of truth, simplify example content#95pkosiec wants to merge 1 commit into
pkosiec wants to merge 1 commit into
Conversation
3c62aca to
906cc32
Compare
906cc32 to
703a5de
Compare
Add "Implementation guidance" preamble to dev-guidelines.md telling agents to use installed Databricks skills for implementation patterns. Update intent blocks (recipe, cookbook, example) to treat skills as the authoritative source when template content overlaps. Simplify inventory-intelligence example to outcome-only (remove structured interview and design sections). Remove duplicate CLI auth verification from buildFullPrompt() — the local-bootstrap block already handles it. Add skills reference to ai-chat-app cookbook intro. Co-authored-by: Isaac
703a5de to
19c1d7c
Compare
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
Companion to databricks-agent-skills PR #76.
⚠️ databricks/databricks-agent-skills#76 should be merged first!
Establishes Databricks agent skills as the single source of truth for implementation patterns, while keeping DevHub templates as the discovery and context layer.
What changes for agents
dev-guidelines.mdtells agents the template describes what to build, and installed skills provide the how.buildFullPrompt()— removed duplicate CLI auth verification steps that the local-bootstrap block already covers.What changes for users
inventory-intelligencecontent simplified to outcome-only (Data Flow + What to Adapt). The "Setup — interview the user" section is removed (see below).ai-chat-appintro now mentions that installed skills provide implementation patterns.Why we removed the "interview the user" pattern
The
inventory-intelligenceexample had a structured 8-question interview (workspace URL, CLI profile, catalog, warehouse ID, Lakebase project, data mode, Genie tab, forecast model) baked intocontent.md. This is no longer needed because:intent-example.md) already define the conversational flow — clarify intent, pin down decisions, ask one question at a timetemplate/README.mdhas the actual setup instructionsWith skills as the source of truth, agents discover what to ask as they go — they don't need a pre-baked questionnaire.
Test plan
npm run buildpassesnpm run testpasses (255/255)npm run typecheckpasses/templates/inventory-intelligence)/api/markdown)/templates/ai-chat-app)