$ recombobulate _
home / tips / add-a-decisions-section-to-claudemd-to-prevent-repeated-debates
0

Add a "Decisions" Section to CLAUDE.md to Prevent Repeated Debates

bagwaa @bagwaa · Mar 26, 2026 · Configuration
add-a-decisions-section-to-claudemd-to-prevent-repeated-debates

Claude approaches every session without memory of previous conversations. If you spent 20 minutes debating whether to use REST or GraphQL and chose REST, Claude will happily re-open that debate next time if you don't record the decision.

A ## Decisions section in your CLAUDE.md closes that loop permanently.

## Decisions

### Architecture
- REST over GraphQL — we don't have complex nested query requirements
- Postgres only — no Redis caching layer until we have real performance data
- No ORM abstractions beyond what Laravel provides — direct Eloquent only

### Frontend
- Vue 3 Composition API — no Options API in new components
- Tailwind for styling — no custom CSS except for animations
- No jQuery — vanilla JS or Vue reactivity only

### Testing
- Pest for PHP tests — PHPUnit syntax only where Pest doesn't support it
- No snapshot testing — it creates noise in diffs without catching real regressions

When Claude sees this section, it stops proposing alternatives you've already rejected. It also stops asking clarifying questions about choices that are already settled.

You can be direct when writing decisions in:

## Decisions
- We are NOT switching to microservices. Do not suggest it.
- Authentication uses Sanctum, not Passport. Do not propose changing this.
- We use uuid() for primary keys. Do not use auto-incrementing integers.

Update this section whenever a meaningful debate gets resolved — it becomes a living record of your project's technical philosophy.

Every decision you document is a debate you never have to have again.

~/recombobulate $ tip --comments --count=0

Log in to leave a comment.

~/recombobulate $ tip --related --limit=3
0
Switch to the Stable Update Channel with autoUpdatesChannel

The autoUpdatesChannel setting pins Claude Code to a stable release track that skips versions with major regressions.

bagwaa @bagwaa · 1 hour ago
0
Set Claude's Response Language with the language Setting

The language setting makes Claude respond in your preferred language by default, across every session and project.

bagwaa @bagwaa · 1 hour ago
0
Customize or Remove Claude's Git Attribution with the attribution Setting

The attribution setting lets you customize or completely remove Claude's Co-Authored-By trailer from git commits and pull requests.

bagwaa @bagwaa · 1 hour ago