Skip to main content

25 docs tagged with "workflow"

View all tags

address-review

Pull all PR review comments (any reviewer, human or bot), classify each as convergent (a fix) or divergent (a design disagreement), apply convergent ones after sign-off, escalate divergent ones to the author as questions. The single path for responding to a PR review; wires /continue step 11.

agent-guard

Enforces the required_agents declared by matched policies at runtime. Run at step 5 of /continue and as a self-check before any Edit/Write, to verify the right expert agents are in context for the files touched. Matches policies by triggered_by globs; blocks until every missing agent is loaded.

brainstorm-spec

For an ad-hoc dev task with no PRD — brainstorm the approach, converge on a short written spec, and get explicit approval BEFORE writing code. A lightweight design-before-code gate. Triggers on "let's design this", "how should I approach", "brainstorm this".

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".

Bring up the local stack (+ optionally exercise a change)

Bring the local BeWith stack up and confirm it is healthy — sandbox infra (Mongo/MySQL/Redis/LocalStack) plus the NestJS services (headless "Debug-Watch All Services") — then optionally exercise a change end-to-end. Idempotent; the hands-on counterpart to /verify.

claude-init

Initialize an existing bewith-dev repo onto the platform — scaffold CLAUDE.md + the CI caller, retire legacy .cursor rules (archive, then rewrite repo-specific ones into CLAUDE.md), verify the plugin + git hooks load. Worktree-isolated; prepares a reviewable branch, never merges.

cto-review

Opens a CTO-review ticket in a dedicated ClickUp list, carrying the full handoff package (problem, UI composition, design reference, acceptance criteria, links). Title convention [Feature name] informative title, tag cto review. Runs at the end of the product flow or manually off-flow.

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", "תעד את ההחלטה".

delegate-heavy-context

Decide when and how to push token-heavy operations into a subagent (or use cheaper tool alternatives) so only a short verdict returns to the main thread. Implements the subagent-as-context-firewall lever from context-and-cost-economy.md.

design-an-interface

Turn a screen/feature requirement into a concrete UI composition from the design system — which COMPONENTS.md components, layout, states, and tokens — the machine-consumable design reference when there's no Figma (Path B). Flags gaps as /add-component; never invents components or raw hex.

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", "סיימנו").

favorite-session

Favorite/pin a Claude Code session so you can find and reopen it later. Pins the current session (by $CLAUDE_CODE_SESSION_ID) to a private GitHub gist so favorites follow you across machines; lists, opens, and removes them. Invoked by /favorite, /favorites, /open-favorite, /unfavorite.

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.

launch-checklist

Feature-level release-readiness before shipping a whole feature to production — flag + kill-switch, staged rollout, rollback plan, release notes/version, monitoring + post-deploy watch, comms, success metrics. Broader than the per-PR DoD. Produces a checklist; gates nothing automatically.

mermaid-diagrams

Create version-controllable software diagrams with Mermaid's text syntax — flowcharts, sequence, class, ERD, C4/architecture, state. Use when documenting architecture, a data model, an API/auth flow, or a DB schema, or any "diagram / visualize / map out the flow" request.

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.

postman-endpoint

Save an added or changed HTTP endpoint in the organization R&D Postman workspace with a sample request and a saved response example, at the end of development. The Definition-of-Done step for API work — keeps the collection an accurate, runnable contract. Never commits secrets.

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.

sessions-view

Read the local per-machine session registry and render a cross-session mission-control view — branch, cwd, files, age, live/stale, collisions, and which sessions are waiting on the developer. Optionally launches a self-refreshing HTML dashboard. Read-only; invoked by /sessions.

state-sync

Keeps a task's state mirrored across both trackers — writes the AI Context block to the GitHub Issue and a condensed mirror to the ClickUp ai_context field, and maintains the bidirectional link so any session knows which ClickUp task an Issue belongs to. Runs at checkpoints; never gated.

systematic-debugging

A 4-phase active-fix loop — reproduce, isolate, hypothesize+instrument, fix+verify — with a hard stop after 3 failed attempts. Instruments at the gateway/RPC/service/Mongo boundaries. Triggers on "debug this", "why is this failing", "help me fix this bug".

test-driven-development

Drive a change test-first — a failing test, then minimum code to pass, then refactor. Adapted to the bewith Jest/NestJS stack. The Iron Law — no production code before a failing test. Triggers on "TDD this", "test first", "drive this test-first".

watch-deploy

After a merge, watch the deployment to its target environment and the observability stack for a defined window before the task closes. Confirms the deploy succeeded and telemetry is clean (vendor-neutral); on a regression it flags an incident instead of closing the task.