eweser-db

Use this skill to run a focused browser feedback checkpoint for completed EweserDB UI work. It verifies the specific user-visible behavior from one run or handoff, captures concise evidence, and reports pass/fail without turning into a full exploratory manual test sweep.

Use this skill to implement a feature in the EweserDB monorepo from a plan file. Also use it when the user invokes $eweser-coder, asks Codex to code an approved EweserDB plan, continue a run from docs/ai/plans, fix a bug, or make repo changes while preserving quality gates. Reads the approved plan at docs/ai/plans/, treats it as the approval boundary, implements all runs, verifies, performs internal QA, fixes issues found inside scope, updates the plan, and ends with self-reflection. Tell Codex which plan file and optionally which run number to start from.

Use this skill to create a GitHub pull request for completed EweserDB work. Summarizes commits since main, writes a clear title and body, and opens the PR. Use after QA has passed.

Use this skill for standalone re-QA or audit of completed EweserDB work. Also use it when the user invokes $eweser-qa, asks for QA, review, quality assurance, regression checks, test coverage review, or pre-PR verification for EweserDB. Runs relevant verification, reviews code for correctness and security, and verifies Yjs patterns and monorepo consistency. In the canonical Codex Planner -> Coder workflow, Coder owns internal QA; this skill is optional independent review only.

Use this skill in the EweserDB repo when the user wants to stress-test a feature, plan, product decision, or naming choice against EweserDB domain language before implementation. It uses GLOSSARY-MAP.md, package GLOSSARY.md glossaries, INDEX.md navigation, AGENTS.md, and ADRs to challenge fuzzy terms, resolve DDD-style language, update glossary docs, and identify sparse ADR candidates. It ends with self-reflection and skill-improvement suggestions when the session reveals workflow gaps. Planner-style only: do not edit product code.

Use this skill to create a scoped implementation plan for a feature in the EweserDB monorepo. Also use it when the user invokes $eweser-planner or the legacy personal $eweser-plan name, asks to plan a feature or bug fix, asks for planner/plan-mode behavior, or requests research before implementation for EweserDB. Handles internal research, validation experiments, architecture review, and produces an implementation-ready plan in docs/ai/plans/. Use before starting substantial or ambiguous coding work. Planner stops for user approval and does not implement product code.

Use this skill to manually test completed EweserDB work from a plan file or coder handoff. Verifies local behavior through browser/MCP/API flows, records evidence, reports bugs with reproduction steps, and does not implement fixes.

Use this skill in the EweserDB repo when the user asks to analyze recent Codex session performance, agent flailing, context bloat, missing background knowledge, weak prompts, poor skill triggering, repeated sidequests, or adoption of INDEX.md and code-map/graph lookup workflows. Runs the local session retrospective tooling, inspects high-signal evidence, and makes targeted improvements to skills, workflow docs, indexes, helper scripts, or retrospective heuristics so future agents get relevant context faster.

Use this skill for EweserDB runtime orientation before running tests/services. It reduces guesswork for local/prod endpoints, worktree-specific ports, and repeated environment setup checks.

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.

Use this skill to debug the EweserDB Docker Compose local development stack. Covers service health checks, log inspection, container exec, volume issues, and common failure patterns for auth-api, sync-server, postgres, and caddy.

Use this skill to create and apply a Drizzle ORM database migration in the EweserDB auth server at packages/auth-server-hono. Guides schema changes, migration generation, review, and application. Use whenever the PostgreSQL schema needs to change.

Use this skill to release updated npm packages from the EweserDB monorepo. Guides the changeset, version bump, build, and publish flow for @eweser/db, @eweser/shared, and @eweser/examples-components.

Use this skill to debug Yjs CRDT issues in the EweserDB SDK. Covers Y.Doc state inspection, provider connection troubleshooting, sync conflicts, and common patterns for diagnosing why data is not persisting or syncing.