Zayin/Ekklesia
3
0
Fork 0
Code Issues 6 Pull Requests 1 Actions Packages Projects Releases 9 Wiki Activity

CLAUDE.md still forbids starting Stage 1 work (Settings, global Displays, theme editor, installer, responsive shell) #102

New Issue
Open
opened 2026-10-14 13:03:17 +00:00 by ekklesia-bot · 0 comments
ekklesia-bot commented 2026-10-14 13:03:17 +00:00
Member
Copy Link
Copy Source

What I observed

CLAUDE.md at the repository root (at 44430b5) still tells agents not to start Stage 1 work:

Displays are transitional. … Today's device pairing (the Dashboard sidebar's Display devices panel) and Signage's own display roster are a transitional implementation that Stage 1 migrates to Settings → Displays. Fix defects in them, but do not build the Stage 1 Settings, global Displays, theme editor, module installer, or responsive shell redesign early, and keep existing paired displays working across any change.

(lines 57–61; line 51 also calls hard-coded shell strings "known debt for Stage 1".)

Stage 0 is complete (Core v0.2.5, Signage v0.1.5 released), and the maintainer has started Stage 1 (Dashboard / UX / Settings / Platform Management Foundation). Stage 1 consists of exactly the work this paragraph prohibits: Settings, global Displays, the theme editor, the module installer, and the responsive shell.

Impact

An agent following CLAUDE.md literally will either refuse Stage 1 tasks or have to decide for itself that the instruction no longer applies. That conflicts with the repository's own rule to prefer ROADMAP.md/DESIGN.md and never silently follow stale text. The part that should survive is "keep existing paired displays working across any change", which still matters throughout Stage 1.

Suggested fix

Reword the bullet for Stage 1, for example: displays and devices are platform-owned; Stage 1 moves pairing and display identity to Settings → Displays; until a slice migrates them, fix defects in the transitional Display devices panel and Signage's roster rather than extending them; and every change must keep existing paired displays working. Also drop "known debt for Stage 1" once the branding slice lands.

What I did not look at

The CLAUDE.md files in Zayin/Signage and Zayin/Classroom_Desktop, which may carry similar Stage 0 wording.

Found by Claude while planning Ekklesia Stage 1 and implementing its first slice (Dashboard URL routing).

## What I observed `CLAUDE.md` at the repository root (at `44430b5`) still tells agents not to start Stage 1 work: > **Displays are transitional.** … Today's device pairing (the Dashboard sidebar's *Display devices* panel) and Signage's own display roster are a transitional implementation that Stage 1 migrates to **Settings → Displays**. Fix defects in them, but do not build the Stage 1 Settings, global Displays, theme editor, module installer, or responsive shell redesign early, and keep existing paired displays working across any change. (lines 57–61; line 51 also calls hard-coded shell strings "known debt for Stage 1".) Stage 0 is complete (Core v0.2.5, Signage v0.1.5 released), and the maintainer has started Stage 1 (Dashboard / UX / Settings / Platform Management Foundation). Stage 1 consists of exactly the work this paragraph prohibits: Settings, global Displays, the theme editor, the module installer, and the responsive shell. ## Impact An agent following `CLAUDE.md` literally will either refuse Stage 1 tasks or have to decide for itself that the instruction no longer applies. That conflicts with the repository's own rule to prefer `ROADMAP.md`/`DESIGN.md` and never silently follow stale text. The part that should survive is "keep existing paired displays working across any change", which still matters throughout Stage 1. ## Suggested fix Reword the bullet for Stage 1, for example: displays and devices are platform-owned; Stage 1 moves pairing and display identity to **Settings → Displays**; until a slice migrates them, fix defects in the transitional *Display devices* panel and Signage's roster rather than extending them; and every change must keep existing paired displays working. Also drop "known debt for Stage 1" once the branding slice lands. ## What I did not look at The `CLAUDE.md` files in `Zayin/Signage` and `Zayin/Classroom_Desktop`, which may carry similar Stage 0 wording. --- Found by Claude while planning Ekklesia Stage 1 and implementing its first slice (Dashboard URL routing).
ekklesia-bot added the found-by-claude label 2026-10-14 13:03:17 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
found-by-claude
Found by Claude while working on another task
No labels found-by-claude
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
Joey Zayin_Admin ekklesia-bot
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Zayin/Ekklesia#102