You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+90-7Lines changed: 90 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,6 +58,24 @@ Create context files that persistently guide tools about your project's structur
58
58
> "`CLAUDE.md` is a special file that Claude automatically pulls into context when starting a conversation. This makes it an ideal place for documenting: common bash commands, core files and utility functions, code style guidelines, testing instructions."
**Claude Code**: Run `/init` to auto-generate smart context files that make Claude understand your codebase instantly. Claude analyzes dependencies, scripts, and architecture automatically. Use `/memory` to edit and add project-specific gotchas.
65
+
66
+
- For new projects: Run `/init` in your project root to create a starter `CLAUDE.md`
67
+
- For existing codebases: Run `/init` and Claude will analyze your project structure, dependencies, and configuration files to automatically generate essential information
68
+
- Use `/memory` for full editor interface or `#` as quick shortcut to add notes
69
+
- Memory file hierarchy: `~/.claude/CLAUDE.md` (global) and `./CLAUDE.md` (project-specific)
70
+
71
+
**Cursor**: Create `AGENTS.md` for project rules, then use @codebase and @docs for dynamic context. Cursor's superpower is real-time understanding of your entire codebase through @-mentions.
72
+
73
+
- Create `AGENTS.md` at project root (also supports legacy `.cursorrules`)
74
+
- Real-time context: Use `@codebase` to pull in relevant files automatically, `@docs` to reference documentation, `@git` to understand recent changes
75
+
- Combine static rules (AGENTS.md) with dynamic context (@-mentions) for best results
76
+
77
+
</details>
78
+
61
79
### Write Detailed Specs
62
80
63
81
Give comprehensive specs - even a conversational spec beats vague instructions.
@@ -258,6 +276,26 @@ Stop waiting for one AI agent to finish before starting another - run multiple a
258
276
> "I disable all permission checks. Which basically means I run claude --dangerously-skip-permissions. More specifically I have an alias called claude-yolo set up."
- When to use full-auto: Systematic refactoring tasks, bulk file operations, lint fixes and code cleanup
296
+
297
+
</details>
298
+
261
299
### Learn From It, Code Yourself
262
300
263
301
Use assistants to learn new languages and concepts, then apply that knowledge when you code.
@@ -272,27 +310,54 @@ Begin with faster/cheaper models for routine tasks, then escalate to more powerf
272
310
> "Sonnet 4 handles 90% of tasks effectively. Switch to Opus when Sonnet gets stuck. Recommend starting with Sonnet and providing comprehensive context."
**Claude Code**: Use `/model` to switch between models based on task complexity. Start with cheaper Sonnet 4 for routine work, escalate to fast Opus 4.1 when stuck.
317
+
318
+
- Use `/model` to switch models during your session
319
+
- Cheaper, faster option: `Claude Sonnet 4`
320
+
- Top-graded option: `Claude Opus 4.1`
321
+
322
+
**Codex CLI**: Use `/model` to escalate when needed. Start with `gpt-5-medium` for most tasks, switch to `gpt-5-high` when you hit complex problems.
323
+
324
+
- Use `/model` to switch models during your session
325
+
- Cheaper, faster option: `gpt-5-medium`
326
+
- Top-graded option: `gpt-5-high`
327
+
328
+
</details>
329
+
275
330
### Build Fast, Foolproof Tools
276
331
277
332
Create tools that respond quickly, provide clear error messages, and protect against being used incorrectly by AI agents.
278
333
279
334
> "Tools need to be fast. The quicker they respond (and the less useless output they produce) the better. Crashes are tolerable; hangs are problematic. Tools need to be user friendly! Tools must clearly inform agents of misuse or errors to ensure forward progress. Tools need to be protected against an LLM chaos monkey using them completely wrong. There is no such thing as user error or undefined behavior!"
Begin with faster/cheaper models for routine tasks, then escalate to more powerful models only when you hit complex problems.
285
-
286
-
> "Sonnet 4 handles 90% of tasks effectively. Switch to Opus when Sonnet gets stuck. Recommend starting with Sonnet and providing comprehensive context."
Reset the AI's context window between unrelated tasks to prevent confusion and improve performance on new problems.
292
340
293
341
> "During long sessions, Claude's context window can fill with irrelevant conversation, file contents, and commands. This can reduce performance and sometimes distract Claude. Use the `/clear` command frequently between tasks to reset the context window."
**Claude Code**: Use `/clear` command to reset the context window and start fresh.
348
+
349
+
- Run `/clear` between unrelated tasks to prevent context pollution
350
+
- Preserves your memory files (CLAUDE.md) while clearing conversation history
351
+
- Essential for long coding sessions to maintain performance
352
+
353
+
**Cursor**: Start new chat sessions or use conversation management features.
354
+
355
+
- Use Cmd/Ctrl+Shift+L to start a new chat for unrelated tasks
356
+
- Chat history is automatically managed to prevent context overload
357
+
- Use @-mentions to bring in specific context when starting fresh
358
+
359
+
</details>
360
+
296
361
### Use Strong Emphasis in Prompts
297
362
298
363
Use IMPORTANT, NEVER, ALWAYS liberally in prompts to steer AI away from common mistakes - it's still the most effective approach.
@@ -307,6 +372,24 @@ Don't let AI go too far down the wrong path - interrupt, provide feedback, and r
307
372
> "Press Escape to interrupt Claude during any phase (thinking, tool calls, file edits), preserving context so you can redirect or expand instructions. Double-tap Escape to jump back in history, edit a previous prompt, and explore a different direction. You can edit the prompt and repeat until you get the result you're looking for."
0 commit comments