#1118 - feat(web): /specs route — list + markdown editor (no AI drawer) - charles/claude-hooks

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.

Blocks

#1119 feat(web): architect-backed AI drawer on /specs/$specName

charles/claude-hooks

#1120 feat(web): breakdown toolbar + open-in-chat on /specs/$specName

charles/claude-hooks

#1121 refactor(web): /workspace chat-only — strip spec mode, drop ?spec/?task params

charles/claude-hooks

Depends on

#1117 feat(web): nav split — add chat + specs entries, drop merged workspace label

charles/claude-hooks

Reference

charles/claude-hooks#1118

claude-desktop commented

2026-05-11 23:39:02 +00:00

Collaborator

As an operator,
I want /specs to list spec files and /specs/$specName to open a focused markdown editor,
so that spec authoring lives on its own page instead of sharing /workspace.

Replaces the redirect-only specs.tsx / specs.index.tsx / specs.$specName.tsx shells. AI drawer + breakdown toolbar land in follow-up stories.

Acceptance criteria

List (`/specs`)

routes/specs.index.tsx renders a list of specs/*.md entries fetched via fetchArchitectFiles(repo) filtered by root === "specs".
Empty state with "New spec" button creates specs/<kebab>.md then navigates to /specs/<name>.
Sticky ?repo=<o/n> selector mirrors the workspace pattern.
Each row links to /specs/$specName.

Editor (`/specs/$specName`)

routes/specs.$specName.tsx mounts SpecEditor with body loaded via fetchArchitectFileContent.
Save action calls saveSpec and surfaces role="status" aria-live="polite" toast.
Unsaved-changes guard: navigating away with dirty body prompts Base UI Dialog confirm.
Cmd+S / Ctrl+S saves (added to a new useSpecsKeymap hook).

Layout wrapper

routes/specs.tsx replaces the redirect stub with an <Outlet /> shell; validateSearch accepts repo.
AppShell chrome rendered on both list and editor.

Tests

specs.test.tsx covers: list renders rows, click navigates to editor; editor loads body, save fires PUT /architect/files; unsaved-changes guard fires on dirty navigate.
No regression in workspace.test.tsx (still passes pre-split).

Out of scope

AI drawer integration (story wsplit-3).
Breakdown toolbar + "Open in chat" (story wsplit-4).
Removing spec branches from /workspace (story wsplit-5).

Dependencies

Blocked by wsplit-1 (nav must list /specs first).

References

Spec: docs/specs/workspace-split.md § Surfaces > /specs.

**As an** operator, **I want** `/specs` to list spec files and `/specs/$specName` to open a focused markdown editor, **so that** spec authoring lives on its own page instead of sharing /workspace. Replaces the redirect-only `specs.tsx` / `specs.index.tsx` / `specs.$specName.tsx` shells. AI drawer + breakdown toolbar land in follow-up stories. ## Acceptance criteria ### List (`/specs`) - [ ] `routes/specs.index.tsx` renders a list of `specs/*.md` entries fetched via `fetchArchitectFiles(repo)` filtered by `root === "specs"`. - [ ] Empty state with "New spec" button creates `specs/<kebab>.md` then navigates to `/specs/<name>`. - [ ] Sticky `?repo=<o/n>` selector mirrors the workspace pattern. - [ ] Each row links to `/specs/$specName`. ### Editor (`/specs/$specName`) - [ ] `routes/specs.$specName.tsx` mounts `SpecEditor` with body loaded via `fetchArchitectFileContent`. - [ ] Save action calls `saveSpec` and surfaces `role="status" aria-live="polite"` toast. - [ ] Unsaved-changes guard: navigating away with dirty body prompts `Base UI Dialog` confirm. - [ ] `Cmd+S` / `Ctrl+S` saves (added to a new `useSpecsKeymap` hook). ### Layout wrapper - [ ] `routes/specs.tsx` replaces the redirect stub with an `<Outlet />` shell; `validateSearch` accepts `repo`. - [ ] `AppShell` chrome rendered on both list and editor. ### Tests - [ ] `specs.test.tsx` covers: list renders rows, click navigates to editor; editor loads body, save fires `PUT /architect/files`; unsaved-changes guard fires on dirty navigate. - [ ] No regression in `workspace.test.tsx` (still passes pre-split). ## Out of scope - AI drawer integration (story wsplit-3). - Breakdown toolbar + "Open in chat" (story wsplit-4). - Removing spec branches from `/workspace` (story wsplit-5). ## Dependencies - Blocked by wsplit-1 (nav must list `/specs` first). ## References - Spec: `docs/specs/workspace-split.md` § Surfaces > /specs.

claude-desktop added this to the workspace-split milestone

claude-desktop added the

labels

claude-desktop added a new dependency

2026-05-11 23:39:43 +00:00

Rows
Columns

feat(web): /specs route — list + markdown editor (no AI drawer) #1118

Acceptance criteria

List (/specs)

Editor (/specs/$specName)

Layout wrapper

Tests

Out of scope

Dependencies

References

List (`/specs`)

Editor (`/specs/$specName`)