This commit is contained in:
samuelm00
2025-08-19 06:32:27 +02:00
committed by yetone
parent 6da110b1c0
commit 24f7dbbe76

106
README.md
View File

@@ -63,81 +63,87 @@ If you like this project, please consider supporting me on Patreon, as it helps
- **One-Click Application**: Quickly apply the AI's suggested changes to your source code with a single command, streamlining the editing process and saving time.
- **Project-Specific Instruction Files**: Customize AI behavior by adding a markdown file (`avante.md` by default) in the project root. This file is automatically referenced during workspace changes. You can also configure a custom file name for tailored project instructions.
## Project Instructions with avante.md
## project instructions with avante.md
The `avante.md` file allows you to provide project-specific context and instructions to the AI. This file should be placed in your project root and will be automatically referenced during all interactions with Avante.
the `avante.md` file allows you to provide project-specific context and instructions to the ai. this file should be placed in your project root and will be automatically referenced during all interactions with avante.
### Best Practices for avante.md
### best practices for avante.md
To get the most out of your project instruction file, consider following this structure:
to get the most out of your project instruction file, consider following this structure:
#### Your Role
#### your role
Define the AI's persona and expertise level for your project:
define the ai's persona and expertise level for your project:
```markdown
### Your Role
### your role
You are an expert senior software engineer specializing in [technology stack]. You have deep knowledge of [specific frameworks/tools] and understand best practices for [domain/industry]. You write clean, maintainable, and well-documented code. You prioritize code quality, performance, and security in all your recommendations.
you are an expert senior software engineer specializing in [technology stack]. you have deep knowledge of [specific frameworks/tools] and understand best practices for [domain/industry]. you write clean, maintainable, and well-documented code. you prioritize code quality, performance, and security in all your recommendations.
```
#### Your Mission
#### your mission
Clearly describe what the AI should focus on and how it should help:
clearly describe what the ai should focus on and how it should help:
```markdown
### Your Mission
### your mission
Your primary goal is to help build and maintain [project description]. You should:
your primary goal is to help build and maintain [project description]. you should:
- Provide code suggestions that follow our established patterns and conventions
- Help debug issues by analyzing code and suggesting solutions
- Assist with refactoring to improve code quality and maintainability
- Suggest optimizations for performance and scalability
- Ensure all code follows our security guidelines
- Help write comprehensive tests for new features
- provide code suggestions that follow our established patterns and conventions
- help debug issues by analyzing code and suggesting solutions
- assist with refactoring to improve code quality and maintainability
- suggest optimizations for performance and scalability
- ensure all code follows our security guidelines
- help write comprehensive tests for new features
```
#### Additional Sections to Consider
#### additional sections to consider
- **Project Context**: Brief description of the project, its goals, and target users
- **Technology Stack**: List of technologies, frameworks, and tools used
- **Coding Standards**: Specific conventions, style guides, and patterns to follow
- **Architecture Guidelines**: How components should interact and be organized
- **Testing Requirements**: Testing strategies and coverage expectations
- **Security Considerations**: Specific security requirements or constraints
- **project context**: brief description of the project, its goals, and target users
- **technology stack**: list of technologies, frameworks, and tools used
- **coding standards**: specific conventions, style guides, and patterns to follow
- **architecture guidelines**: how components should interact and be organized
- **testing requirements**: testing strategies and coverage expectations
- **security considerations**: specific security requirements or constraints
### Example avante.md
### example avante.md
```markdown
# Project Instructions for MyApp
# project instructions for myapp
## Your Role
You are an expert full-stack developer specializing in React, Node.js, and TypeScript. You understand modern web development practices and have experience with our tech stack.
## your role
## Your Mission
Help build a scalable e-commerce platform by:
- Writing type-safe TypeScript code
- Following React best practices and hooks patterns
- Implementing RESTful APIs with proper error handling
- Ensuring responsive design with Tailwind CSS
- Writing comprehensive unit and integration tests
you are an expert full-stack developer specializing in react, node.js, and typescript. you understand modern web development practices and have experience with our tech stack.
## Project Context
MyApp is a modern e-commerce platform targeting small businesses. We prioritize performance, accessibility, and user experience.
## your mission
## Technology Stack
- Frontend: React 18, TypeScript, Tailwind CSS, Vite
- Backend: Node.js, Express, Prisma, PostgreSQL
- Testing: Jest, React Testing Library, Playwright
- Deployment: Docker, AWS
help build a scalable e-commerce platform by:
## Coding Standards
- Use functional components with hooks
- Prefer composition over inheritance
- Write self-documenting code with clear variable names
- Add JSDoc comments for complex functions
- Follow the existing folder structure and naming conventions
- writing type-safe typescript code
- following react best practices and hooks patterns
- implementing restful apis with proper error handling
- ensuring responsive design with tailwind css
- writing comprehensive unit and integration tests
## project context
myapp is a modern e-commerce platform targeting small businesses. we prioritize performance, accessibility, and user experience.
## technology stack
- frontend: react 18, typescript, tailwind css, vite
- backend: node.js, express, prisma, postgresql
- testing: jest, react testing library, playwright
- deployment: docker, aws
## coding standards
- use functional components with hooks
- prefer composition over inheritance
- write self-documenting code with clear variable names
- add jsdoc comments for complex functions
- follow the existing folder structure and naming conventions
```
## Installation
@@ -162,7 +168,7 @@ For building binary if you wish to build from source, then `cargo` is required.
---@type avante.Config
opts = {
-- add any opts here
-- this file can containe specific instructions for your project
-- this file can contain specific instructions for your project
instructions_file = "avante.md"
-- for example
provider = "claude",