Skip to content

docs(readme): restructure for readability and de-duplicate install - #77

Merged
atamanvega merged 1 commit into
mainfrom
docs/readme-restructure
Sep 10, 2026
Merged

atamanvega merged 1 commit into
mainfrom
docs/readme-restructure

Conversation

@atamanvega

Copy link
Copy Markdown
Collaborator

What

Reorganizes the README into a clearer top-down flow — the content felt a bit chaotic (install steps in particular were duplicated in three places). No substance changed; everything is preserved verbatim, just regrouped and de-duplicated.

New structure

  1. Título + badges + pitch + Demo (demo stays at the top, next to the pitch)
  2. What it does — the issue-to-PR flow · from idea to backlog · quality gates · stack-agnostic
  3. Getting started — a single Installation section (wizard + per-host table + Claude Code / Codex / Copilot / Cursor subsections + the cross-client explainer) · Connect your tracker
  4. Using it — first use · day-to-day · try without a ticket · parallel stories
  5. Reference — what's inside · relationship to repos · extending
  6. Meta — telemetry · troubleshooting · license

Key change

The install one-liner + per-host table was duplicated across three sections ("How it works", "Installing in Claude Code", "Also runs on Codex/Cursor/Copilot"). Those are now one Installation section with per-host subsections. Internal anchors updated accordingly (#installing-in-claude-code#installation, #cursor--…#cursor); the redundant inline troubleshooting note is already covered by the Troubleshooting table.

Scope

Docs-only. The README is not bundled into the plugin, so no version bump and no rebuild needed.

🤖 Generated with Claude Code

Reorganize the README into a clearer top-down flow without changing any
substance:

- Group content into "What it does" (issue-to-PR flow, plan-backlog,
  quality gates, stack-agnostic), "Getting started" (one Installation
  section + connect-your-tracker), "Using it", "Reference", and meta.
- Consolidate the install one-liner + per-host table, which was
  duplicated in three places, into a single Installation section with
  per-host subsections (Claude Code, Codex, Copilot, Cursor, and the
  cross-client explainer that "Also runs on…" used to hold).
- Keep the demo at the top next to the pitch.
- Fix internal anchors after the moves (#installing-in-claude-code →
  #installation, #cursor--… → #cursor, dropped the absorbed
  "also-runs-on" anchor); the redundant inline troubleshooting note is
  covered by the Troubleshooting table.

Docs-only; README is not bundled, so no version bump or rebuild.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
claude-dev-kit-telemetry-relay Ignored Ignored Sep 10, 2026 5:32pm UTC

Request Review

@atamanvega
atamanvega merged commit d7e1fb9 into main Sep 10, 2026
3 checks passed
@atamanvega
atamanvega deleted the docs/readme-restructure branch September 10, 2026 17:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant