Skip to content

Commit 751f256

Browse files
docs: remove agent-only scaffolding from the public repo
Someone reading the repo flagged the committed skill/agent folders. Fair — they were build scaffolding for us, sitting in a directory strangers read. Removed docs/superpowers/plans/ (4,127 lines). Four implementation plans for work that shipped in v0.6/v0.7, written as task-by-task checklists addressed to "agentic workers" and referencing sub-skills by name. Meaningless to anyone else, and they made the docs directory look like a construction site. Removed docs/agents/. domain.md was the worst of it: 35 lines describing how to consume CONTEXT.md and docs/adr/, neither of which exists in this repo — a doc pointing at nothing. issue-tracker.md and triage-labels.md were real but redundant; CLAUDE.md already carried the label vocabulary inline, so the pointers have been folded into a plain "Issues" section that also names the issue template. Git history keeps all of it if we ever want to look back. KEPT CLAUDE.md deliberately. It's a recognized convention rather than a leak, and for this project it's the actual architecture reference — the numbering scheme, the channels.json schema, the surgical-deploy invariants, the rules about never delete-recreating a live channel. A contributor is better off with it than without, and much of what it documents exists nowhere else. 348 tests still pass; nothing removed was referenced by code, docs, or the build. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent 916c157 commit 751f256

8 files changed

Lines changed: 5 additions & 4212 deletions

CLAUDE.md

Lines changed: 5 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -464,16 +464,9 @@ intact. Live franchise channels carry `playback: interleaved` by default (see ch
464464
authoring UI and status cards), full rationale, rejected alternatives, and history:
465465
[`docs/live-channels-design.md`](docs/live-channels-design.md).
466466

467-
## Agent skills
467+
## Issues
468468

469-
### Issue tracker
470-
471-
Issues are tracked in GitHub Issues (`AlpineArchitecture/programmarr`) via the `gh` CLI. See `docs/agents/issue-tracker.md`.
472-
473-
### Triage labels
474-
475-
Default vocabulary: `needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human`, `wontfix`. See `docs/agents/triage-labels.md`.
476-
477-
### Domain docs
478-
479-
Single-context — one `CONTEXT.md` + `docs/adr/` at the repo root. See `docs/agents/domain.md`.
469+
Tracked in GitHub Issues (`AlpineArchitecture/programmarr`) via the `gh` CLI. Label
470+
vocabulary: `needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human`, `wontfix`.
471+
Bug reports come in through `.github/ISSUE_TEMPLATE/`, which requires the Programmarr and
472+
Tunarr versions and the media-source type — the three fields that explain most reports.

docs/agents/domain.md

Lines changed: 0 additions & 35 deletions
This file was deleted.

docs/agents/issue-tracker.md

Lines changed: 0 additions & 22 deletions
This file was deleted.

docs/agents/triage-labels.md

Lines changed: 0 additions & 15 deletions
This file was deleted.

0 commit comments

Comments
 (0)