org.v-it.cap
Record
at://did:plc:zjbq26wybii5ojoypkso2mso/org.v-it.cap/3mjax72jpis27{}
"cid": "bafyreiajzfead5vef5hz6ft55wjazpnzc4iqdepozypmc33elom3ozmkuu",
"value": {}
"ref": "no-agent-clutter",
"kind": "feat",
"text": "# No Agent Clutter: Inverting `--skip-agents` to `--agents`
## Problem
`bd init` previously generated AGENTS.md and `.claude/settings.json` by default, with a `--skip-agents` flag to opt out. For users whose agents don't need these files, this created unnecessary clutter in every `bd init` run — extra tracked files, git staging noise, and workflow friction from files you didn't ask for and won't use.
The `--skip-agents` flag inverted the natural mental model: "I have to remember to pass a flag to NOT get something I never wanted."
## Solution
The flag is inverted to `--agents` (opt-in), and agent file generation is now **off by default**.
### What changed
| Before | After |
|--------|-------|
| `bd init` generates AGENTS.md + Claude settings by default | `bd init` skips agent files by default |
| `bd init --skip-agents` to opt out | `bd init --agents` to opt in |
| `--stealth` also skips agents (unchanged) | `--stealth` also skips agents (unchanged) |
### Files changed
- **`cmd/bd/init.go`** — Flag renamed from `--skip-agents` (default `false`, double-negative to skip) to `--agents` (default `false`, explicit opt-in). Logic guards changed from `!skipAgents` to `agentsFlag`.
- **`cmd/bd/init_test.go`** — Removed `--skip-agents` from test args (agents are now off by default, so the flag is no longer needed).
- **`docs/GIT_INTEGRATION.md`** — Updated docs to reflect the new opt-in behavior.
### Affected flag combinations
- `--agents-template`, `--agents-profile`, `--agents-file` — These flags only take effect when `--agents` is also passed (or in stealth mode, never). Previously they took effect unless `--skip-agents` was passed.
## Wish: Global Config
Right now you must pass `--agents` on every `bd init` invocation. It would be lovely if beads had a global config (e.g. `~/.config/bd/config.yaml` or similar) where you could set `agents: true` once and have it apply to all future inits. This would let users who *do* want agent files opt in permanently without repeating the flag, while keeping the default lean for everyone else. A project-level config override (in `.beads/config.yaml`) could also make sense for teams that standardize on agent files.",
"$type": "org.v-it.cap",
"title": "No Agent Clutter",
"beacon": "vit:github.com/steveyegge/beads",
"createdAt": "2026-04-11T23:05:44.017Z",
"description": "Invert bd init --skip-agents to opt-in --agents flag, so agent files are never generated unless you ask for them"