Skip to content

Add product template system for new contributions#21

Open
MrFixit96 wants to merge 2 commits into
hashicorp:mainfrom
MrFixit96:add-product-templates
Open

Add product template system for new contributions#21
MrFixit96 wants to merge 2 commits into
hashicorp:mainfrom
MrFixit96:add-product-templates

Conversation

@MrFixit96
Copy link
Copy Markdown

@MrFixit96 MrFixit96 commented Feb 3, 2026

Summary

  • Add reusable templates for contributing new products, plugins, and skills
  • Follow patterns established by existing Terraform and Packer plugins
  • Include discovery questions for agent-assisted automation

Structure

examples/
├── .claude-plugin/plugin.json
├── README.md                           # Comprehensive contributor guide
├── spec.md                             # GitHub Spec-Kit style template
├── questionnaire.md                    # Discovery questions for automation
├── commands/
│   └── new-product/
│       └── COMMAND.md                  # Interactive scaffolding command
└── new-product-template/
    └── {product}/
        ├── README.md.template
        └── {use-case}/
            ├── .claude-plugin/plugin.json.template
            └── skills/
                └── {skill-name}/SKILL.md.template

Changes

  • Created examples/README.md with step-by-step instructions for adding products, plugins, and skills
  • Created examples/spec.md GitHub Spec-Kit style specification template
  • Created examples/questionnaire.md with discovery questions for agent automation
  • Created examples/new-product-template/ with placeholder-based templates
  • Created examples/commands/new-product/ for interactive scaffolding via /new-product
  • Added CONTRIBUTING.md with contribution guidelines and workflow

Testing

  • Templates validated against existing Terraform and Packer plugin structures
  • All placeholder patterns ({product}, {use-case}, {skill-name}) documented

@MrFixit96 MrFixit96 requested a review from a team as a code owner February 3, 2026 06:53
@hashicorp-cla-app
Copy link
Copy Markdown

hashicorp-cla-app Bot commented Feb 3, 2026

CLA assistant check
All committers have signed the CLA.

@hashicorp-cla-app
Copy link
Copy Markdown

CLA assistant check

Thank you for your submission! We require that all contributors sign our Contributor License Agreement ("CLA") before we can accept the contribution. Read and sign the agreement

Learn more about why HashiCorp requires a CLA and what the CLA includes

Have you signed the CLA already but the status is still pending? Recheck it.

@MrFixit96 MrFixit96 force-pushed the add-product-templates branch from 3c2d336 to 26fd922 Compare February 3, 2026 07:03
Add reusable templates and documentation for contributing new products:

## Templates (examples/)

- examples/new-product-template/ - Directory structure with placeholders
- examples/spec.md - GitHub Spec-Kit style specification template
- examples/questionnaire.md - Discovery questions for automation
- examples/README.md - Comprehensive guide for contributors
- examples/commands/new-product/ - Interactive scaffolding command

## Documentation

- CONTRIBUTING.md - Contribution guidelines with workflow

Templates follow patterns established by existing Terraform and Packer plugins,
enabling consistent structure for future product additions.
@MrFixit96 MrFixit96 force-pushed the add-product-templates branch from 26fd922 to 23a5990 Compare February 3, 2026 07:08
@MrFixit96
Copy link
Copy Markdown
Author

Note on examples/ Directory

The examples/ directory contains a meta-plugin with a /new-product command for scaffolding new products interactively. This plugin is intentionally not registered in marketplace.json because:

  1. It provides commands, not skills - The plugin has a commands/ directory rather than a skills/ directory
  2. CI validation requires skills/ - The validation script expects all marketplace plugins to have a skills/ subdirectory
  3. Local-only functionality - The scaffolding command is intended for contributors working locally, not for distribution via the marketplace

The plugin works correctly when the repository is cloned locally - users can run /new-product to interactively create a new product structure. It just does not need to be published to the marketplace since it is a development/contribution tool rather than an agent skill.

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