ds-disable ยท diff
git:20260725.18f8707 to git:20260808.703818a
5 added, 5 removed. Audit A to A.
---
name: ds-disable
description: "Append the agentic-engineering opt-out marker to the project"
user-invocable: true
---
# /ds-disable
Append the agentic-engineering opt-out marker to the project
`AGENTS.md` (creating it if absent). Optionally also updates the global
config. Refuses to overwrite an existing opt-in marker without
`--force`.
- Implementation: `bin/agentic-disable` (Python 3 stdlib).
+ Implementation: `bin/ds-disable` (Python 3 stdlib).
## Usage
```
- agentic-disable # write opt-out to project AGENTS.md
- agentic-disable --global # also update ~/.claude/agentic-engineering.json
- agentic-disable --force # remove existing opt-in marker first, then append opt-out
- agentic-disable --global --force
+ ds-disable # write opt-out to project AGENTS.md
+ ds-disable --global # also update ~/.claude/agentic-engineering.json
+ ds-disable --force # remove existing opt-in marker first, then append opt-out
+ ds-disable --global --force
```
## Behavior
The script resolves the project `AGENTS.md` (following `CLAUDE.md`
`@AGENTS.md` import if present) and:
1. **Opt-in conflict gate.** If `AGENTS.md` contains a whole-line
`agentic-engineering: opt-in` (case-insensitive, optional `- `
prefix), the command exits non-zero (exit code 2) without modifying
any file. The error message names the absolute path and line number
of the existing marker. Pass `--force` to remove the opt-in line
first, then append opt-out.
2. **Idempotency.** If `AGENTS.md` already contains a whole-line
`agentic-engineering: opt-out`, the command is a no-op (exit 0)
and prints the existing marker location.
3. **Append insertion point.** When opt-out is appended, the script
guarantees a blank line separates it from the prior content:
- File ending in `\n\n` or empty: append `agentic-engineering: opt-out\n`.
- File ending in `\n` but not `\n\n`: append `\nagentic-engineering: opt-out\n`.
- File not ending in `\n`: append `\n\nagentic-engineering: opt-out\n`.
Atomic write via tmp + rename - partial writes cannot leave
`AGENTS.md` corrupted.
4. **Missing AGENTS.md auto-create.** If `AGENTS.md` does not exist,
the script creates it with a single line: `agentic-engineering: opt-out\n`.
Rationale: the user invoked `/ds-disable`, an explicit opt-out
signal; creating `AGENTS.md` with the marker is the
minimum-blast-radius way to record that intent.
## `--global`
Updates `~/.claude/agentic-engineering.json` with `mode=opt-out` and a
fresh `set_at` ISO8601 UTC timestamp. **Preserves existing keys
verbatim**: the helper writes back the same set of keys it read; absent
keys remain absent. The script will not invent any key not already
present in the file.
If the config file is missing, it is created with the minimal shape
`{"mode": "opt-out", "set_at": "<iso>"}`.
## `--force`
When an `agentic-engineering: opt-in` line is present in `AGENTS.md`,
`--force` removes the entire line (including its trailing newline,
leading whitespace, and any `- ` list prefix) before appending the
opt-out marker. The removed line is recoverable via git. The
confirmation output prepends a `--force: removed existing 'opt-in'
marker at line <N>.` line to the standard write summary.
## Exit codes
- `0` - success or idempotent no-op
- `1` - I/O error (read-only filesystem, permission denied, etc.)
- `2` - opt-in conflict and `--force` was not passed; no files modified
## Reversibility
`/ds-disable` is reversible: the marker is one line in a tracked
file, and the JSON edit is round-trippable. `--force` is also
reversible because the removed `opt-in` line is recoverable from git.
The command is direct-action eligible - no extra confirmation prompt.