---
name: Zero Drift
description: Two-rule grounding system — named responses and a living task document for seamless context handoff
when_to_use: always — activate at session start as global behavior baseline
version: 1.1.0
languages: all
---

# Zero Drift

> No hallucination. No drift. No losing track.

Two rules. Active every response. No exceptions.

---

## Rule 1: Named Response

Every reply starts with the user's name.

**Purpose — hallucination detector.** The name is the canary. When the model starts drifting or hallucinating, the name is the first thing to break: dropped, altered, or off-tone. The user watches for this. The instant it slips, the session is degrading — the user opens a fresh window, says "read the TASK.md and continue", and resumes clean. So: never drop the name, never alter it. A consistent name = a grounded session.

### How to find the name

Run these in order, stop at the first hit:

1. `git config user.name` — use the result
2. Scan `CLAUDE.md` / `AGENTS.md` / `GEMINI.md` for a line like `MY_NAME=` or `name:` in a personal/user section
3. Check if the user introduced themselves earlier in this session
4. **If nothing found → ask once:**
   > "What's your name? I'll use it throughout our session."
   Store the answer for the rest of the session.

### Format

```
[Name]: [rest of response]
```

Example:
```
Breno: the login bug is in auth/middleware.ts:42 — token expiry uses `<` instead of `<=`.
```

**Never skip the name. Never forget mid-session.**

---

## Rule 2: Living Task Document

Every specific task gets a `TASK.md` in the project root. Update it after every prompt that advances the task.

### When to create

Create `TASK.md` when the user starts something specific:
- "Let's build X"
- "Fix this bug"
- "I want to create a Y"
- Any session where the work has a name and a goal

If a `TASK.md` already exists in the project root, **read it before doing anything else in that task**.

### When NOT to auto-read

A new Claude instance does **not** read `TASK.md` automatically. The user must ask explicitly:

> "Read the TASK.md and continue" / "Leia o TASK.md e continue"

Only then load and follow the document.

### Document structure

```markdown
# TASK: [Task Name]
> Created: YYYY-MM-DD | Updated: YYYY-MM-DD HH:MM

## Goal
[What we're building/fixing — 2-3 sentences max]

## Plan
- [x] Completed step
- [ ] Pending step

## Log
### YYYY-MM-DD
- Did X using Y
- Fixed Z — was doing W, now does V
- Added A to handle edge case B

## Errors & Fixes
| Error | Cause | Fix |
|-------|-------|-----|
| `TypeError: X` | Missing null check | Added guard at line 42 |

## Current State
[1-2 paragraphs for a fresh Claude instance: what was built, what works,
what's broken, what's next. Write this last. Keep it current.]
```

### Update rules

- Update **after every prompt** that does something meaningful
- Log = what was done, not what was planned
- `Current State` always reflects right now — rewrite it, don't append
- If you made a mistake and fixed it, log both: what broke and how it was fixed
- Keep the file readable — no noise, no filler

### Handoff protocol

When starting a new session on an ongoing task, the user will say something like:
- "Read the TASK.md and continue"
- "Leia o TASK.md e continue"
- "Continue from where we left off — check TASK.md"

On that trigger:
1. Read `Current State` first
2. Read `Log` (most recent entries)
3. Read `Plan` (check vs uncheck)
4. Confirm understanding: "Got it. We're at [X], next is [Y]. Continuing."
5. Do not redo completed steps

---

## Activation

Recommended — install as a plugin so a `SessionStart` hook activates these rules in every session automatically:

```
/plugin marketplace add obrenoalvim/zero-drift
/plugin install zero-drift@zero-drift
```

Manual fallback — paste this into `~/.claude/CLAUDE.md`:

```markdown
# Zero Drift Skill
Always follow the Zero Drift rules from: https://github.com/obrenoalvim/zero-drift

Rules:
1. Start every response with the user's name (detect from git config, CLAUDE.md, or ask)
2. For every specific task, maintain and update TASK.md in the project root
```

Or paste the full SKILL.md content directly into your CLAUDE.md.

---

## Quick Reference

| Situation | Action |
|-----------|--------|
| First response, name unknown | Ask for name, then use it |
| Name found in git config | Use it immediately |
| New task starts | Create TASK.md |
| Task already has TASK.md | Read it first |
| New session, same task | Wait for explicit "read TASK.md" |
| After every meaningful prompt | Update TASK.md log + Current State |