Contributing Guide

How to contribute knowledge assets to OpenDDD

Contribution Types

1. Prompts

Create a .md file under the corresponding category in skills/prompts/:

# Prompt Title

> One-line description

## Prompt

\`\`\`
Your prompt content, using {{variable}} placeholders
\`\`\`

## Usage Example

**Input**: Example input
**Output**: Example output

## Tags

\`type.prompt\` \`domain.xxx\` \`lang.xxx\` \`role.xxx\` \`maturity.draft\`

2. Workflows

Create a .md file under the corresponding category in skills/workflows/, each step must have clear input/output.

3. Roadmaps

Create a .md file under the corresponding category in skills/roadmaps/, each stage must have a practical project.

4. Recipes

Create a directory under skills/recipes/, containing README + scripts/configs.

Contribution Process

1. Fork the repository
2. Create knowledge asset (following the format above)
3. Add tags (following the tag system)
4. Update indexes (in skills-indexing/)
5. Submit PR

Naming Conventions

• File names: lowercase + hyphens (ddd-entity-generation.md)
• Variable placeholders: double curly braces ()
• Workflow steps: ## Step N: ...
• Roadmap stages: ## Phase N: ...