Skip to content

Prompt Engineering Standards #1267

Description

@ashleyshaw

Overview

Create docs/PROMPTS_STANDARDS.md — prompt engineering best practices, reusable templates, and testing strategies.

Research & Content Creation

Planning Reference:

Research Prompt:

Document prompt standards. Research and create:

  1. Prompt engineering principles — From Anthropic guidelines
  2. Reusable templates vs. one-off prompts distinction
  3. Folder structureprompts/{name}.md pattern
  4. Template anatomy — Frontmatter (name, version, use-case, model, temperature), template with placeholders, inputs/outputs
  5. Best practices:
    • Role/persona clarity
    • Task specificity
    • Constraints & guidelines
    • Output format specs
    • Few-shot examples
  6. Versioning & updates
  7. Testing prompts — Validation approach
  8. Governance — Who owns prompt standards

Mermaid diagrams (2-3 required):

  • Prompt engineering process: design → test → iterate
  • Prompt decision tree: when to create reusable template

External links:

Definition of Ready

  • Planning reviewed
  • Anthropic documentation reviewed

Definition of Done

File: docs/PROMPTS_STANDARDS.md
Epic: #1261 | PR: #1251

Metadata

Metadata

Assignees

Fields

Priority

None yet

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions