Working with New Applications and Existing Repositories

The Walnut Agent adapts its workflow based on whether you are building a new application or working with an existing repository. The agent remains the default interface, dynamically transitioning between modes as required by the task.

Building a New Application

To start a project from scratch:

• Create a folder on your local machine and open it in VS Code.

• Activate the Walnut extension and select the project.

• Provide the Agent with your high-level requirement (for example, “Build a Task Management API”). Once submitted, the Agent proceeds through the following structured workflow:

  • Analyze: The Agent reviews your request and automatically enters Plan Mode to create a structured technical roadmap.

  

  • Clarify: If any information is unclear or incomplete, WalnutAI triggers a Q&A mechanism to gather the necessary details, ensuring it avoids assumptions and does not hallucinate.

  

  • Implement: After you approve the proposed plan, the Agent begins implementation, requesting explicit permission before running terminal commands or making significant changes.

  

Working with an Existing Repository

To enhance or maintain an existing project:

• Clone the repository manually using VS Code.

• Open the project folder to allow the Agent to scan dependencies, frameworks, and architectural patterns.

• Start prompting for specific use cases like bug fixes, refactoring, or documentation.