Skip to content

feat: add dev-best-practices skill, deprecate databricks-config#298

Open
michael-berk wants to merge 2 commits intodatabricks-solutions:mainfrom
michael-berk:michael-berk_data/tame-palm
Open

feat: add dev-best-practices skill, deprecate databricks-config#298
michael-berk wants to merge 2 commits intodatabricks-solutions:mainfrom
michael-berk:michael-berk_data/tame-palm

Conversation

@michael-berk
Copy link

@michael-berk michael-berk commented Mar 12, 2026

Summary

  • Adds new dev-best-practices skill with 5 comprehensive reference docs covering foundations, code quality, architecture, Databricks platform,
    and productionization
  • Deprecates databricks-config skill (content superseded by the new skill)
  • Minor cross-reference updates to databricks-asset-bundles, databricks-python-sdk, and databricks-zerobus-ingest skills

Test plan

  • Verify skill installs correctly via the install script
  • Confirm dev-best-practices SKILL.md trigger conditions are correct
  • Confirm databricks-config deprecation is clean (no stale references)

This pull request was AI-assisted by Isaac.

Adds a new skill distilled from the FDE Technical Playbook (Niall Turbitt,
AI FDE) covering engineering best practices for Databricks FDE engagements:
Git workflow, code quality, software architecture, Databricks platform
patterns, CI/CD, testing philosophy, and production handoff.

- CREATE databricks-skills/databricks-fde-playbook/ (6 files):
  SKILL.md, 1-foundations-and-setup.md, 2-code-quality.md,
  3-architecture.md, 4-databricks-platform.md, 5-productionization.md
- DELETE databricks-skills/databricks-config/ - MCP-specific workspace
  switching with no standalone value; CLI auth covered by FDE playbook
- UPDATE databricks-python-sdk and databricks-asset-bundles SKILL.md
  with cross-references to the new FDE playbook skill

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- **[databricks-spark-declarative-pipelines](../databricks-spark-declarative-pipelines/SKILL.md)** - pipeline definitions referenced by DABs
- **[databricks-app-apx](../databricks-app-apx/SKILL.md)** - app deployment via DABs
- **[databricks-app-python](../databricks-app-python/SKILL.md)** - Python app deployment via DABs
- **[databricks-config](../databricks-config/SKILL.md)** - profile and authentication setup for CLI/SDK
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We are dropping this skill in favor of FDE playbook

@calreynolds calreynolds self-requested a review March 12, 2026 20:49
…e FDE references

- Rename skill directory and update name/description in SKILL.md
- Generalize all FDE-specific language in sub-files
- Update cross-references in databricks-asset-bundles, databricks-python-sdk, databricks-zerobus-ingest
- Update app.yaml ENABLED_SKILLS and databricks-skills/README.md
- Fix stale databricks-config references from deprecation

Co-authored-by: Isaac
@michael-berk michael-berk changed the title feat: add databricks-fde-playbook skill, deprecate databricks-config feat: add dev-best-practices skill, deprecate databricks-config Mar 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant