platform-awareness

PLATFORM AWARENESS

TL;DR: Always identify the operating system at the beginning of a task. Prefer built-in tools over platform-specific commands when available. When terminal commands are necessary, adapt them according to the platform.

🔧 TOOLS-FIRST APPROACH

Use these built-in tools as your first choice:

• list_dir - For listing directory contents (instead of dir/ls)
• edit_file - For creating/editing files (instead of echo/touch)
• read_file - For examining file contents
• Use relative paths directly with tools (no cd needed)
• run_terminal_cmd - For terminal commands (ONE AT A TIME)

🖥️ PLATFORM IDENTIFICATION

At the INITIALIZATION phase of every task, identify the platform:

### Platform Detection
Current environment: [Windows/Mac/Linux]
Path separator: [\ or /]

🚨 KEY PLATFORM DIFFERENCES

Operation	Windows	Mac/Linux
Path separator	\ (backslash)	/ (forward slash)
Create empty file	echo.> filename.txt	touch filename.txt
Create nested dirs	Create one by one	mkdir -p path/to/dir
List directory	dir	ls
Check if dir exists	if exist dir\NUL	if [ -d dir ]
Check if file exists	if exist file.txt	if [ -f file.txt ]
Delete file	del file.txt	rm file.txt
Delete directory	rmdir /s /q dir	rm -rf dir

📦 WEB DEVELOPMENT WORKFLOW

For modern web development environments like Vite/React:

NPM Commands (Safe across platforms)

# Installing dependencies
npm install            # Install all dependencies from package.json
npm install react      # Install a single package
npm install react react-dom  # Install multiple packages at once

# Running scripts
npm run dev            # Start development server
npm run build          # Build for production
npm run test           # Run tests

# Creating projects
npm create vite@latest my-app -- --template react

Vite Development (Safe across platforms)

# Starting dev server
cd project-directory
npm run dev

# Building
npm run build

# Previewing build
npm run preview