a11y-review
On-demand accessibility audit of UI code against WCAG 2.1 AA + RTL/Hebrew. Audits React/Next/MUI components, reports P1/P2/P3 findings with cite + before/after fix. Use for an a11y review / accessibility pass; called by frontend-developer and design-system.
Breakdown — task / design → GitHub issues
Break a feature / ClickUp parent task / design doc into one or more GitHub issues with the BeWith 6-section template + AI-assigned effort/urgency/domain labels. Triggers on phrases like "break down this task", "create issues for this design", "פצל את המשימה הזאת ל-issues".
Decision record — discussion → durable record → tasks
Capture a discussion that reached decisions into a durable record — an ADR (technical) or a decision log entry (product/business) — then offer to break its action items into tasks via /breakdown. Worktree-isolated. Triggers on "record this decision", "תעד את ההחלטה".
Draft proposal
Turn a feature / infrastructure / process idea into a markdown file under docs/proposals/ in bewith-docs. Worktree-isolated, safe across concurrent sessions. Invoked by /propose or by Claude after the developer confirms.
End session — memory + handoff wrap-up
Walks Claude through a session wrap-up — lists PRs touched, scans memory for stale references, and writes or confirms memory entries before the session closes. Invoked manually via /end-session, or by Claude when the developer signals closure ("done", "thanks", "סיימנו").
i18next-translation
Find hardcoded user-facing strings, replace them with t() calls, and add the keys to both he/en locale files. Use when translating components, internationalizing text, or converting hardcoded strings. Owned by i18n-localization; used by frontend-developer.
identify-bug
Identify and document a bug from inputs (description, logs, screenshots, JAM links, a ClickUp task) for someone else to fix — without implementing the fix unless asked. Gathers inputs, traces the flow, finds root cause, writes a structured understanding doc. Called by qa-engineer.
incident-report
Render a finished incident / investigation into a browser-viewable RTL-Hebrew HTML report artifact (via the Artifact tool) — root cause, evidence, impact, timeline, fix. Use after investigating, not for finding bugs (see identify-bug).
insight
Capture a what's-missing / could-change POC observation into docs/insights/ — fast, separate from proposals. Worktree-isolated. Invoked by /insight or when the developer voices a gap or possible change during the build. Does NOT create a proposal; the 2-3 day review promotes agreed insights.
New artifact authoring
Create or update a platform artifact (agent, skill, command, rule, hook, policy) in bewith-docs. Walks the artifact-types decision tree, audits for duplication, drafts file(s), opens a PR. Triggers on phrases like "create an agent", "add a skill", "צריך command".
next-task — what should I start next?
Rank my open ClickUp tasks + assigned GitHub Issues by priority → urgency → effort and recommend what to start next; --fits-in Nm/Nh/Nd filters to what fits a time box. Read-only; the ranking is computed in a script, not by the model. Invoked by /next-task.
obs-logs
Search and analyze production logs — Grafana (Loki + CloudWatch) is the working backend, Datadog EU is legacy fallback. Use to check logs, investigate a production error, analyze volume/patterns, or debug from logs. Called by observability + identify-bug.
permissions-demo-tokens
Find example users with a specific permission role (super-admin, organization-admin, community-admin, leader) in the local backend SQL DB and generate JWT tokens for them via the sandbox token CLI. Use to get demo users + JWTs to test permission levels locally. Called by auth-security.
Propose team rule
Turn a generic insight into a reviewable PR on bewith-docs for team discussion. Worktree-isolated, safe across concurrent sessions. Invoked by /share-rule or by Claude after the developer confirms. Never auto-invoke without explicit approval — each PR consumes review attention.
restore-code
Recover lost or clobbered code from the automatic safety snapshots — falls back to git reflog/stash/dangling blobs. Triggered by /restore, free language ("I lost code"), or proactively when Claude detects dropped code. Diffs and confirms before writing; reversible.
Role — view or change your platform-discovery filter
View or change your role (dev or product). Role controls which capabilities the capability-awareness hook and /help-me surface to you — dev role sees dev-tagged artifacts, product role sees product-tagged artifacts, both see "both"-tagged ones. Invoked via /role. Default role is dev.
Sentinel triage
Triage a production/staging signal for BeWith — verify, locate, classify, recommend; returns one JSON verdict. Read-only. Triggers on /sentinel-check, "triage this error", "is this a real bug", or investigating a prod/staging signal.
Settings — view or change your per-developer preferences
View or change your BeWith developer settings (conversation language, role, default language, notifications, docs path) from one place. Backed by ~/.bewith/config.json — works in chat as a table plus set, opens a local HTML page, and mirrors the SwiftBar menu. Invoked via /settings.