This directory contains contribution templates for the Frontier Analytics section of the Viva Insights Sample Code Library. Use these templates to create consistent, high-quality additions to the prompt library, starter kits, and schema documentation.
Frontier Analytics relies on a consistent structure so that analysts, consultants, and coding agents can quickly find what they need and trust that every prompt card, starter kit, and schema document follows the same pattern. Templates make it easy to contribute without guessing at the expected format.
| Template | Purpose | When to use |
|---|---|---|
| Prompt Card Template | Create a new prompt card for the prompt library | You have a repeatable analytics workflow that can be driven by a coding agent |
| Starter Kit Template | Create a new starter kit (a multi-prompt workflow) | You want to package several prompt cards into an end-to-end analysis workflow |
| Schema Doc Template | Document a new data schema or data source | You need to describe a Viva Insights export format, Purview log format, or other data source |
-
Copy the template. Open the relevant template file and copy its contents into a new file in the appropriate directory:
- Prompt cards →
frontier-analytics/prompts/<category>/ - Starter kits →
frontier-analytics/starter-kits/<kit-name>/ - Schema docs →
frontier-analytics/schemas/
- Prompt cards →
-
Fill in every section. Replace all placeholder text (marked with
[brackets]) with your actual content. Remove any guidance comments once you have addressed them. -
Review against the checklist. Each template includes a quality checklist at the end. Verify your content meets all criteria before submitting.
-
Submit a pull request. Open a PR against the
mainbranch of microsoft/viva-insights-sample-code. In your PR description, note which template you used and summarize what your contribution adds.
This repository follows the standard Microsoft open-source contribution process. Before submitting:
- Sign the Microsoft CLA if you haven't already.
- Ensure your content does not include proprietary data, tenant-specific column names, or personally identifiable information.
- Review the Code of Conduct and Support documents.
If you are unsure which template to use or how to structure your contribution, open an issue on the repository and tag it with frontier-analytics.