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)