メニュー
Implements and debugs Room TBA contributor edit proposals (suggest an edit, review queue, approve/reject, create proposals). Use when working on edit_proposals, proposal-service, Suggest an edit UI, admin review routes, proposal edge cases, or issue
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Anti-AI-slop design skill for greenfield pages, audits, redesigns, and design extraction from URLs or screenshots. Use when the user asks to build a new app or landing page, wants to redesign something, invokes Hallmark by name, or uses audit/redesign/study. Room TBA: also read references/room-tba.md before map chrome, sidebar, or editor UI work.
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
Write structured handoff prompts when ending a session or delegating to another agent (Claude, Codex, Cursor). Use when user says handoff, delegate, continue in new chat, or epic spans multiple sessions.
Review diffs for over-engineering only — delete, stdlib, native, yagni, shrink. Use after a fat agent diff, before merge, or when user says ponytail-review, simplify review, what can we delete. Codex/Claude: use @ponytail-review plugin skill when installed.
Louis Rossmann anti-AI-slop rules for prose (README, docs, MDX, PRs, blog). From realrossmanngroup/no_ai_slop_writing_rules. Use when writing or editing any user-facing text. Not for code generation.
Default workflow for smmariquit repositories. Use at the start of any task — read README, match conventions, minimal diffs, no secrets in commits, verify before redoing infra work. Check for stack-specific skills in this repo (.cursor/skills/).
| name | contributor-proposals |
| description | Implements and debugs Room TBA contributor edit proposals (suggest an edit, review queue, approve/reject, create proposals). Use when working on edit_proposals, proposal-service, Suggest an edit UI, admin review routes, proposal edge cases, or issue |
Policy and architecture: AGENTS.md. Edge cases: docs/issue-test-matrix.md and GitHub #255.
Contributor edits in map app → pending edit_proposals row → editor review → approve publishes live data
/api/admin/*).| Layer | Path |
|---|---|
| Service | src/lib/services/proposal-service.ts |
| Public API | src/pages/api/proposals/index.ts |
| Admin review | src/pages/api/admin/proposals/ |
| Client helpers | src/lib/proposals/client.ts |
| UI | RoomResult.svelte, BuildingResult.svelte, SuggestAdditionPanel.svelte, ProposalReviewPanel.svelte |
| Schema | drizzle/schema.ts (edit_proposals), drizzle/0005_add_edit_proposals.sql |
| Notifications | src/lib/notifications/proposal-events.ts (see discord-notifications) |
| Status | Meaning |
|---|---|
pending | Awaiting editor |
needs_changes | Editor sent back with note; contributor may revise |
approved | Published (or failed publish rolled back to prior status) |
rejected | Closed |
create_* types).POST /api/proposals → submitProposal() creates or merges an open proposal (same entity + submitter).proposal.submitted → Discord #contributors.Anonymous: requires submitterName; tracks proposal via localStorage (room-tba-proposal-refs).
Editors use shield menu → review queue:
| Action | API | On success |
|---|---|---|
| Approve | POST /api/admin/proposals/[id]/approve | Atomic publish + editor_history + sync key bump + proposal.reviewed |
| Reject | .../reject | Status rejected + optional note + proposal.reviewed |
| Request changes | .../request-changes | Status needs_changes + required note + proposal.reviewed |
409 on approve: live data changed; proposal stays open; no proposal.reviewed event.
create_building, create_room, …)entity_id = 0, base_version = 0.applyProposalPatch() calls createBuilding, createRoom, etc. in admin-service.ts.proposalId.create_* from one logged-in user may collide on (entity_type, entity_id=0) — fixed: create merges only via explicit proposalId (#255 PR pending).POST /api/proposals/:id/withdraw sets status withdrawn (pending / needs_changes only).| Change | Test |
|---|---|
| Service logic | integration/services/proposals.integration.test.ts |
| Approve 409 | integration stale-version test |
| UI flow | e2e/admin/proposals.spec.ts (partial; expand when stable) |
| Notifications | src/lib/notifications/proposal-events.test.ts |
bun test src/lib/notifications/proposal-events.test.ts
bun run test:integration # when proposal-service or admin routes change
Manual: suggest edit on staging → pending in queue → approve → live map updates; Discord submit + reviewed embeds in #contributors.