Windsurf AI Coding
Built to keep you in flow state
Config Files
By rigorously maintaining these files, you ensure both human and AI collaborators stay aligned, productive, and resilient to context loss—enabling a truly next-generation, AI-augmented software development workflow.
| File/Directory | Purpose |
|---|---|
| PLANNING.md | High-level vision, architecture, constraints, tech stack, tools, guiding principles |
| TASK.md | Tracks current tasks, backlog, sub-tasks, milestones, discoveries |
| .windsurfrules | Project-specific AI rules: tech stack, directory structure, coding standards, forbidden tools |
| global_rules.md | Organization-wide or workspace-wide AI rules |
| .windsurf/plans/ | Directory for detailed planning artifacts (see below) |
| .windsurf/plans/complexity-analysis.md | Analysis of technical challenges, scalability, edge cases |
| .windsurf/plans/feature-order.md | Prioritized feature and dependency list |
| .windsurf/plans/ui-ux.md | UI/UX wireframes, mockups, data structure sketches |
| .windsurf/plans/db-schema.md | Database schema and rationale |
| .windsurf/plans/error-patterns.md | Catalog of recurring errors and mitigation patterns |
| .windsurf/task-logs/ | Directory for persistent task logs |
| refactor.md (optional) | Step-by-step implementation roadmap/checklist |
| README.md | Project overview, setup instructions, usage |
Example Structure
project-root/
├── PLANNING.md
├── TASK.md
├── .windsurfrules
├── global_rules.md
├── README.md
├── .windsurf/
│ ├── plans/
│ │ ├── complexity-analysis.md
│ │ ├── feature-order.md
│ │ ├── ui-ux.md
│ │ ├── db-schema.md
│ │ └── error-patterns.md
│ └── task-logs/
│ └── [date]-[task].md
└── refactor.md (optional)