Prompting Workflow: Implementation Guide Document - da-moon/llm-playground GitHub Wiki

Table Of Contents

1. Overview

Purpose:

The Implementation Guide provides detailed instructions and guidelines on how to implement specific design patterns, frameworks, or technologies within the project. It ensures that all team members follow a consistent approach and understand the best practices associated with the implementation.

When to Use:

  • When introducing a new design pattern, framework, or technology to the project.
  • To provide guidance on how to apply specific implementations consistently across the project.

2. Structure and Content

2.1 Overview

Purpose: Provide an introduction to the design pattern, framework, or technology being implemented.

Content:

  • Introduction: A brief description of what is being implemented and why it is necessary.
  • Use Cases: Scenarios where this implementation is applicable.
  • Benefits: The advantages of using this approach in the project.

2.2 Step-by-Step Instructions

Purpose: Offer detailed, step-by-step guidance on how to implement the pattern or technology.

Content:

  • Step 1:

    • Description: Detailed instructions for the first step.
    • Example: Provide a code snippet or example to illustrate the step.
    • Tools/Resources: Any specific tools, libraries, or resources needed for this step.
  • Step 2:

    • Description: Detailed instructions for the next step.
    • Example: Provide a code snippet or example to illustrate the step.
    • Tools/Resources: Any specific tools, libraries, or resources needed for this step.

(Continue for all implementation steps)

2.3 Best Practices

Purpose: Highlight best practices to ensure the implementation is done correctly and efficiently.

Content:

  • Practice 1:

    • Description: A description of the best practice.
    • Rationale: Why this practice is important and the potential impact of not following it.
    • Example: Provide a real-world example or code snippet.
  • Practice 2:

    • Description: A description of the best practice.
    • Rationale: Why this practice is important and the potential impact of not following it.
    • Example: Provide a real-world example or code snippet.

(Continue for all best practices)

2.4 Examples

Purpose: Provide real-world examples or use cases where this implementation has been successfully applied.

Content:

  • Example 1:

    • Description: A detailed description of the example scenario.
    • Code Snippet: Include any relevant code snippets or diagrams.
    • Outcome: The result or impact of applying the implementation in this scenario.
  • Example 2:

    • Description: A detailed description of the example scenario.
    • Code Snippet: Include any relevant code snippets or diagrams.
    • Outcome: The result or impact of applying the implementation in this scenario.