# free-will

free-will makes the agent stop at a costly fork, lay out real options, test each against evidence and pick one on purpose.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 406 repo stars
- Author: syahiidkamil
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/skills/free-will/SKILL.md
- Updated: 2026-06-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/free-will

## What it does

The skill triggers on its own. Countable events decide: a fix that failed a second or third time, a new dependency, schema or migration work, deleting something other code relies on, a public API change, the stack choice at the start of a build.

Rather than collapsing to the likeliest answer, it keeps several branches open: the urge, the contrarian, the synthesis, out-of-the-box moves, scattered intuitive dots, retrieved precedent, first principles. Every branch names what it sacrifices and rests on at least one fact from outside the model, such as the codebase, docs, a benchmark or a spike. Each one then gets walked forward for blast radius, reversibility and maintenance. The pick is made deliberately, and the winner has to survive an attempt to refute it.

Deliberation burns test-time compute, so routine calls skip it. A branch with no outside fact is guesswork, and the skill treats it that way. Decisions and the rejected branches land in `docs/decision_logs/`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/free-will/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/free-will/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/free-will/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/free-will/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install syahiidkamil/Software-Engineer-AI-Agent-Atlas .claude/skills/free-will
```

2. **Manually: put the files in place**
- File: `.github/skills/free-will/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill free-will -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas --path .claude/skills/free-will
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/free-will/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/skills/free-will/SKILL.md

## When to use it
- decide whether a new dependency earns its place
- design a schema before the first migration
- debug a failure that survived two fix attempts
- plan the removal of an API other services call
- keep a record of rejected designs in `docs/decision_logs/`

## Example prompts
- The fix failed a third time. Lay out the branches, ground each one, then choose.
- We're adding Redis. Run the fork: options, evidence, blast radius, then a decision.
- Design the schema migration and log the rejected branches in `docs/decision_logs/`.

## Similar
- [macrothink](https://affpapa.org/en/nevibecode/skills/macrothink.md) — skill · 1400 installs
- [ce-bakeoff](https://affpapa.org/en/nevibecode/skills/ce-bakeoff.md) — skill · 452 installs
- [brainstorming](https://affpapa.org/en/nevibecode/skills/ganyuanran-brainstorming.md) — skill · ★ 1450 repo stars
- [think](https://affpapa.org/en/nevibecode/skills/think.md) — skill · 15400 installs
- [ce-pov](https://affpapa.org/en/nevibecode/skills/ce-pov.md) — skill · 1200 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/satya-janghu-grill-me.md) — skill · 881 installs

From the same set: [syahiidkamil/software-engineer-ai-agent-atlas](https://affpapa.org/en/nevibecode/by/syahiidkamil/software-engineer-ai-agent-atlas.md) — 26 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
