> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nextd.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Best Practices

> This guide will help you quickly master Nextd development techniques, avoid common pitfalls, and maximize development efficiency.

## Establish Knowledge Documentation Foundation

### Key Content

* **Product Vision**: Clear product goals and core value proposition
* **User Journey**: Detailed description of user roles and usage scenarios
* **Functional Specifications**: List key features and functional requirements
* **Design System**: UI guidelines, style specifications, and component library
* **Role Definitions**: Behaviors and permissions of different user roles

<Tip>
  **Knowledge documentation is your project's "brain"** - it provides AI with complete project context to ensure generated code meets your requirements.
</Tip>

### Implementation Recommendations

Regularly update knowledge documentation to ensure AI always develops based on the latest project information.

## Optimize Prompt Strategy

### Core Techniques

**Specific Descriptions**: Clearly specify page locations and expected behaviors. Use natural language to describe requirements and provide screenshots to enhance contextual understanding.

**Set Development Boundaries**: Define clear work scope for AI, repeat key instructions to ensure understanding, and break complex tasks into testable small chunks.

**Role Specification**: When dealing with multi-role systems, clearly specify the current operating user role to ensure AI generates appropriate code for the correct context.

<Info>
  Adopt progressive development approach, focusing on one specific feature at a time, ensuring each step can be validated.
</Info>

## Effective Use of Chat Mode

### Positioning Philosophy

Treat chat mode as your "AI co-pilot" for deep collaboration and problem solving.

### Usage Timing

**Troubleshooting Scenarios**: Use chat mode after 2-3 consecutive "try fix" failures, when debugging complex logic issues, or when technical challenges require detailed analysis.

**Feature Planning Scenarios**: Leverage chat mode for new feature architecture design, technical solution discussions, and code refactoring planning to ensure comprehensive consideration of all aspects.

<Note>
  **Recommend investing 60-70% of development time in chat mode**, leveraging its powerful analysis and planning capabilities.
</Note>

## Comprehensive Development Strategy

### Tool Combination Usage

| Tool                | Use Case                                      | Benefits                       |
| ------------------- | --------------------------------------------- | ------------------------------ |
| **Version Control** | Use GitHub integration to manage code changes | Track progress and collaborate |
| **Chat Mode**       | Complex logic development and problem solving | Deep analysis and planning     |

### Development Mindset

* Maintain patience and systematic thinking
* Adopt incremental development approach
* Actively utilize community resources and documentation

## Problem Resolution Process

### Steps When AI Enters Loop State

1. **Switch to Chat Mode**\
   Immediately stop current operations and enter interactive problem analysis

2. **Provide Error Screenshots**\
   Share detailed error information and context

3. **Request Deep Investigation**\
   Ask AI to carefully analyze problem root causes and provide solutions

<Note>
  Minimize problem loops through clear requirement descriptions and progressive development.
</Note>

## Conclusion

Successful Nextd development relies on effective human-AI collaboration. By following these best practices, you'll be able to fully leverage AI-assisted development potential and build excellent applications.

**Remember**: Clear communication, systematic approaches, and continuous learning are keys to success.