BeWith repo map
Which BeWith repo does this belong in, and how do they connect. Use when work spans repos, when placing a new feature, when telling an active repo from a deprecated one, or when orienting in a repo for the first time. Covers the iframe-embedded apps and backend-services as shared backend owner.
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.
obs-logs
Search and analyze production logs via Grafana (Loki + CloudWatch). 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.
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.
Provisioning a queue or env var across BeWith environments
Provision an SQS queue, a DLQ, or a shared env var across every BeWith environment - seven places, not two. Covers Kubernetes-deployments and IAC-Terraform, per-environment verification, and the mistakes that leave a queue working in one env only.
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.
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 quality rubric
Framework-agnostic rubric for judging whether an existing unit test earns its keep. 15 principles across 4 groups - can the assertion fail, is it behaviour at the right seam, does it read as a story, is the suite lean - each resolving to Delete, Merge or Rewrite.
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".