Skip to main content

Component Discussion Tool

The Component Discussion Tool is where you transform your high-level specification into a concrete, component-based architecture. It uses AI to suggest architectural components based on your spec and allows you to iteratively refine them through conversation.

Getting Started​

To begin, you must first select a Revision Draft from the dropdown in the header. This draft, created using the Spec Builder, provides the necessary context for the AI.

Generating Initial Components​

Once a draft is selected, you can provide an optional prompt to guide the AI (e.g., "focus on aggregates and domain services") and then click "Get AI Components". The AI will analyze the entire content of your selected draft and generate a list of suggested architectural components.

Generate AI Components from Spec

The Workspace​

The tool's workspace is divided into two main areas:

  1. Suggested Components: This section displays the list of components newly suggested by the AI. You can save them individually or all at once.
  2. Existing Operations in Draft: This section shows all the components that have already been saved to your draft, giving you a clear view of your current architecture.

Refining Components with the AI Chat​

The core of this tool is the AI chat modal, which is available for both suggested and existing components.

  1. Start a Conversation: Click "Discuss with AI" on any component card. Ask the AI to make changes, such as "Add an email attribute to this DTO" or "Refine the description."

  2. Review Structured Suggestions: The AI will respond with a new, structured definition for the component. You can review the proposed changes to the component type, description, and internal definition.

  3. Update the Component: If you are satisfied with the AI's suggestion, click the Update Operation button in the modal's header. This will apply the changes directly to the component in your revision draft.

This iterative process of generating, discussing, and refining allows you to build a robust and well-considered architecture with the help of AI, ensuring that each component aligns perfectly with your project's domain and requirements.