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

Table Of Contents

1. Overview

Purpose:

The Summary Document captures the key decisions, patterns, and design principles discussed during a brainstorming or design session. It serves as a foundational reference point for the project, ensuring that all critical details are documented and can be referenced in future sessions or chat threads.

When to Use:

  • At the end of a brainstorming or design session.
  • When you need to create a reference point before moving on to implementation or a new discussion thread.

2. Structure and Content

2.1 Project Overview

Purpose: Provide a high-level summary of the project, including its goals, architecture, and key components.

Content:

  • Project Name: The title or name of the project.
  • Project Goals: A brief description of the project’s main objectives.
  • Architecture Overview: A summary of the project's architecture, including any key design patterns, frameworks, or technologies being used.
  • Key Components: A list of the primary components or modules within the project, with a brief description of each.

2.2 Key Decisions

Purpose: Document the major decisions made during the session, including the reasoning behind them and their expected impact on the project.

Content:

  • Decision 1:

    • Description: A detailed explanation of the decision.
    • Rationale: Why this decision was made, including any alternatives considered.
    • Impact: How this decision affects the overall project.
  • Decision 2:

    • Description: A detailed explanation of the decision.
    • Rationale: Why this decision was made, including any alternatives considered.
    • Impact: How this decision affects the overall project.

(Continue for all key decisions)

2.3 Design Patterns and Best Practices

Purpose: Capture the specific design patterns, coding standards, and best practices that were established during the session.

Content:

  • Pattern 1:

    • Name: The name of the design pattern or best practice.
    • Description: A detailed explanation of the pattern, including why it was chosen and how it should be applied.
    • Example: Provide a code snippet or example illustrating the pattern.
  • Pattern 2:

    • Name: The name of the design pattern or best practice.
    • Description: A detailed explanation of the pattern, including why it was chosen and how it should be applied.
    • Example: Provide a code snippet or example illustrating the pattern.

(Continue for all patterns and practices)

2.4 Contextual Details

Purpose: Include any additional context that is necessary to understand the project and its design.

Content:

  • Contextual Information:
    • Dependencies: Any dependencies that were discussed or established.
    • Interactions: How different components or modules interact with each other.
    • Environment Considerations: Any environment-specific details that impact the design (e.g., development vs. production).

2.5 Dependencies and Interactions

Purpose: Outline any dependencies between components and how they interact, ensuring no circular dependencies.

Content:

  • Dependency 1:

    • Component: The component that has a dependency.
    • Depends On: The component or module it depends on.
    • Interaction Details: How these components interact and any considerations to avoid circular dependencies.
  • Dependency 2:

    • Component: The component that has a dependency.
    • Depends On: The component or module it depends on.
    • Interaction Details: How these components interact and any considerations to avoid circular dependencies.

(Continue for all dependencies and interactions)

2.6 Next Steps

Purpose: Provide a list of the next steps or tasks that need to be completed based on the discussions in this session.

Content:

  • Task 1:
    • Description: A brief description of the task.
    • Owner: Who is responsible for completing this task.
    • Deadline: When the task should be completed.
  • Task 2:
    • Description: A brief description of the task.
    • Owner: Who is responsible for completing this task.
    • Deadline: When the task should be completed.

(Continue for all next steps)