Skip to main content

18 docs tagged with "manual"

View all tags

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.