Skip to content

Review the client in docs/Review.md - #22

Merged
kineticsystem merged 1 commit into
mainfrom
review-file
Oct 16, 2026
Merged

kineticsystem merged 1 commit into
mainfrom
review-file

Conversation

@kineticsystem

Copy link
Copy Markdown
Owner

Summary

  • docs/Review.md, new: a design review of the React client, src/client, at fac3127, against the reviewer skill and the 14 patterns of the react-developer skill. Ten findings ranked by severity, seven verified with throwaway vitest tests (deleted afterwards), and eight recommendations.
  • .claude/CLAUDE.md: the review is now a separate document, docs/Review.md; docs/ARCHITECTURE.md describes the design and holds no review.

Two findings can overwrite a user's file:

  1. Creating a file named like an XML file the editor does not list (e.g. a launch file) offers Overwrite in a "changed on disk" dialog, and Overwrite replaces the hidden file.
  2. A reload that read the disk before a save finishes after it and shows the old content as saved; the next save conflicts, and Overwrite removes the saved edit.

No code changes. The fixes are left for their own pull requests.

Test plan

  • Read docs/Review.md: its links to src/ and to the sections of docs/ARCHITECTURE.md resolve on GitHub.
  • pnpm run typecheck and vitest run pass at this commit (148 passed, 6 skipped without the native validator).

🤖 Generated with Claude Code

…itecture document

A design review of the React client, src/client, against the reviewer
skill and the react-developer patterns, at fac3127: ten findings, seven
verified with throwaway tests, two of which can overwrite a user's file.
CLAUDE.md now says the review is its own document, docs/Review.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kineticsystem
kineticsystem merged commit 323acd2 into main Oct 16, 2026
2 checks passed
@kineticsystem
kineticsystem deleted the review-file branch October 16, 2026 11:17
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