Plan the DJ online companion; make AGENTS.md canonical #37

Merged
forgejo-admin merged 1 commit from docs/online-companion-planning into main 2026-09-28 06:20:26 +00:00

Problem

The design work for the online companion exists only in an untracked local checkout: the research, the spec, the grilled decisions, the plan, and the task lists for Slices 1–2, which are already merged. CLAUDE.md duplicated what should be canonical AGENTS.md content.

Solution

  • docs/research/2026-09-27-dj-online-companion.md holds the research.
  • projects/2026-09-27-dj-online-companion/ holds the spec, the plan (8 slices) and the task lists for Slices 1–2, now marked complete.
  • ADRs:
    • docs/adr/0001: the app server owns online state.
    • docs/adr/0002: the guest site builds with Bun, not Vite.
    • docs/adr/0003: guests search all of Spotify.
  • CONTEXT.md is a glossary of set, play, online session, passcode, guest, handle, request and related terms.
  • AGENTS.md is canonical, with Why/What/How sections and a pointer to CONTEXT.md. CLAUDE.md and GEMINI.md are @AGENTS.md stubs.

These are docs only; no code changes.

🤖 Generated with Claude Code

## Problem The design work for the online companion exists only in an untracked local checkout: the research, the spec, the grilled decisions, the plan, and the task lists for Slices 1–2, which are already merged. `CLAUDE.md` duplicated what should be canonical `AGENTS.md` content. ## Solution - `docs/research/2026-09-27-dj-online-companion.md` holds the research. - `projects/2026-09-27-dj-online-companion/` holds the spec, the plan (8 slices) and the task lists for Slices 1–2, now marked complete. - ADRs: - `docs/adr/0001`: the app server owns online state. - `docs/adr/0002`: the guest site builds with Bun, not Vite. - `docs/adr/0003`: guests search all of Spotify. - `CONTEXT.md` is a glossary of set, play, online session, passcode, guest, handle, request and related terms. - `AGENTS.md` is canonical, with Why/What/How sections and a pointer to `CONTEXT.md`. `CLAUDE.md` and `GEMINI.md` are `@AGENTS.md` stubs. These are docs only; no code changes. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Research, spec, plan, ADRs 0001-0003 and the CONTEXT.md glossary for the
guest site and app server. CLAUDE.md and GEMINI.md become @AGENTS.md stubs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
forgejo-admin deleted branch docs/online-companion-planning 2026-09-28 06:20:26 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
celilo/tango-dj!37
No description provided.