ldraney/my-vibes-world
1
0
Fork 0
Code Issues 6 Pull requests Projects Releases Packages Wiki Activity Actions

Fix architecture docs: Rails 8 stack, not Vite + remove .claude-no-enforce #8

New issue
Closed
opened 2026-06-19 02:22:36 +00:00 by ldraney · 3 comments
ldraney commented 2026-06-19 02:22:36 +00:00
Owner
Copy link

Type

Bug

Lineage

Standalone — incorrect tech stack documented from initial scaffold.

Repo

ldraney/my-vibes-world

What Broke

Architecture docs and README specify Vite + vanilla HTML/CSS/JS. The actual tech stack is Rails 8 + Hotwire + Importmap + Propshaft + Puma + Tone.js — matching landscaping-assistant.

Also .claude-no-enforce was committed to the repo by mistake in the initial scaffold.

Repro Steps

  1. Read docs/architecture.md tech stack table
  2. Observe: says Vite, vanilla HTML/CSS/JS, nginx
  3. Read README.md
  4. Observe: says "Vite + vanilla HTML/CSS/JS... served by nginx" and "npm run dev # Vite dev server"
  5. Both should reference Rails 8, Hotwire, Importmap, Propshaft, Puma

Expected Behavior

All docs reflect the correct stack: Rails 8 + Hotwire (Turbo/Stimulus) + Importmap Rails + Propshaft + Puma + Tone.js + Spotify Embed API. Same stack as landscaping-assistant. Docker base image: ruby-rails-build:latest. .claude-no-enforce removed from tracked files and added to .gitignore.

Environment

  • Cluster/namespace: n/a (docs only)
  • Service version/commit: 082a115
  • Related alerts: none

Acceptance Criteria

  • docs/architecture.md tech stack table lists Rails 8, Hotwire, Importmap, Propshaft, Puma
  • Deployment pipeline Mermaid updated (no Vite build step, Rails asset precompile instead)
  • Request flow Mermaid updated (Puma, not nginx)
  • Page anatomy reflects Stimulus controllers + Turbo
  • docs/user-stories.md updated if it references Vite
  • README.md Stack section updated (Rails 8 stack, not Vite/nginx)
  • README.md Quick Start section updated (Rails commands, not npm)
  • .claude-no-enforce removed from git
  • .gitignore added with .claude-no-enforce and .current-issue

Related

  • my-vibes-world project
### Type Bug ### Lineage Standalone — incorrect tech stack documented from initial scaffold. ### Repo `ldraney/my-vibes-world` ### What Broke Architecture docs and README specify Vite + vanilla HTML/CSS/JS. The actual tech stack is Rails 8 + Hotwire + Importmap + Propshaft + Puma + Tone.js — matching landscaping-assistant. Also `.claude-no-enforce` was committed to the repo by mistake in the initial scaffold. ### Repro Steps 1. Read docs/architecture.md tech stack table 2. Observe: says Vite, vanilla HTML/CSS/JS, nginx 3. Read README.md 4. Observe: says "Vite + vanilla HTML/CSS/JS... served by nginx" and "npm run dev # Vite dev server" 5. Both should reference Rails 8, Hotwire, Importmap, Propshaft, Puma ### Expected Behavior All docs reflect the correct stack: Rails 8 + Hotwire (Turbo/Stimulus) + Importmap Rails + Propshaft + Puma + Tone.js + Spotify Embed API. Same stack as landscaping-assistant. Docker base image: ruby-rails-build:latest. `.claude-no-enforce` removed from tracked files and added to `.gitignore`. ### Environment - Cluster/namespace: n/a (docs only) - Service version/commit: `082a115` - Related alerts: none ### Acceptance Criteria - [ ] `docs/architecture.md` tech stack table lists Rails 8, Hotwire, Importmap, Propshaft, Puma - [ ] Deployment pipeline Mermaid updated (no Vite build step, Rails asset precompile instead) - [ ] Request flow Mermaid updated (Puma, not nginx) - [ ] Page anatomy reflects Stimulus controllers + Turbo - [ ] `docs/user-stories.md` updated if it references Vite - [ ] `README.md` Stack section updated (Rails 8 stack, not Vite/nginx) - [ ] `README.md` Quick Start section updated (Rails commands, not npm) - [ ] `.claude-no-enforce` removed from git - [ ] `.gitignore` added with `.claude-no-enforce` and `.current-issue` ### Related - `my-vibes-world` project
ldraney changed title from Fix architecture docs: Rails 8 stack, not Vite to Fix architecture docs: Rails 8 stack, not Vite + remove .claude-no-enforce 2026-06-19 02:25:05 +00:00
ldraney commented 2026-06-19 02:26:49 +00:00
Author
Owner
Copy link

Scope Review: NEEDS_REFINEMENT

Review note: review-1516-2026-06-18
Template complete, file targets verified, story traceability confirmed. Two issues found:

  • [BODY] README.md also contains Vite/nginx references (line 14 stack description, line 20 Quick Start commands) but is not covered by any AC. Add two ACs: "README.md stack description updated" and "README.md Quick Start updated from npm/Vite to Rails commands".
  • [SCOPE] Architecture note arch-vibe-pages does not exist in pal-e-docs. Create it to back the arch:vibe-pages label.
## Scope Review: NEEDS_REFINEMENT Review note: `review-1516-2026-06-18` Template complete, file targets verified, story traceability confirmed. Two issues found: - **[BODY]** README.md also contains Vite/nginx references (line 14 stack description, line 20 Quick Start commands) but is not covered by any AC. Add two ACs: "README.md stack description updated" and "README.md Quick Start updated from npm/Vite to Rails commands". - **[SCOPE]** Architecture note `arch-vibe-pages` does not exist in pal-e-docs. Create it to back the `arch:vibe-pages` label.
ldraney commented 2026-06-19 02:43:11 +00:00
Author
Owner
Copy link

Scope refinement after review-1516-2026-06-18 (NEEDS_REFINEMENT):

  1. Added 2 ACs for README.md — Stack section and Quick Start section also reference Vite/nginx and need updating.
  2. Created arch-vibe-pages architecture note in pal-e-docs to back the arch:vibe-pages board label (traceability gap).
Scope refinement after review-1516-2026-06-18 (NEEDS_REFINEMENT): 1. Added 2 ACs for README.md — Stack section and Quick Start section also reference Vite/nginx and need updating. 2. Created `arch-vibe-pages` architecture note in pal-e-docs to back the `arch:vibe-pages` board label (traceability gap).
ldraney commented 2026-06-19 02:44:56 +00:00
Author
Owner
Copy link

Scope Review: READY

Review note: review-1516-2026-06-18-b

Re-review after refinement — both previous issues resolved. README.md ACs added to issue body, arch-vibe-pages note created in pal-e-docs. All 9 ACs verified against codebase, all file targets confirmed, traceability triangle complete. Single-repo scope, estimated 4-5 min agent time, no decomposition needed.

Note: project-my-vibes-world Architecture section in pal-e-docs also has stale Vite/nginx references — downstream doc update after this ticket merges.

## Scope Review: READY Review note: `review-1516-2026-06-18-b` Re-review after refinement — both previous issues resolved. README.md ACs added to issue body, arch-vibe-pages note created in pal-e-docs. All 9 ACs verified against codebase, all file targets confirmed, traceability triangle complete. Single-repo scope, estimated 4-5 min agent time, no decomposition needed. Note: `project-my-vibes-world` Architecture section in pal-e-docs also has stale Vite/nginx references — downstream doc update after this ticket merges.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
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
ldraney/my-vibes-world#8
No description provided.