English · Português
House Party Protocol — by Rushar Labs

House Party Protocol · modules

Module catalogue

Derived from the emitted tree: what each kit installs, resource by resource. Regenerate with python installers/kit-forge-*/tools/catalog_md.py . --write.

Kits at a glance

kitversionskillscommandsagentshooksrulestemplatesscripts
kit-forge1.4.20001000
operator-kit1.6.213221013117
continuity-kit1.4.120030122
lane-kit1.4.11004044
health-kit1.3.32001003
claude-dev-kit1.3.38001002
supabase-pack1.1.22000000
agent-framework-wizard1.2.11000050
dev-squad-kit1.1.1312120000
gotcha-memory1.0.31003000
total33141423132228

Shared resources

Documents that apply to every kit: ARCHITECTURE.md · ARCHITECTURE.pt-BR.md · BENCHMARK.md · BENCHMARK.pt-BR.md · BRAND.md · BRAND.pt-BR.md · CONCEPTS.md · CONCEPTS.pt-BR.md · DESIGN.md · DESIGN.pt-BR.md · GITHUB-DESCRIPTION.txt · GRAPH-MODEL.md · GRAPH-MODEL.pt-BR.md · LOOPS.md · LOOPS.pt-BR.md · MANUAL.html · MANUAL.pt-BR.html · METHOD.md · METHOD.pt-BR.md · PROOF.md · PROOF.pt-BR.md · TIPS.md · TIPS.pt-BR.md · UX-INSTALL-JOURNEY.md · UX-INSTALL-JOURNEY.pt-BR.md

kit-forge 1.4.2

The IP/PII gate plus the kit assembler. ip_pii_linter + kit_assembler (with guard_origins built in) + kit_doctor (verify/install/registry, 6 stages: detect/prereqs/profile/configure/wire-suggest/smoke) + guard_origins + wire_settings + install_git_hook + skill_lint + tools/browse.py (interactive marketplace menu), single exit contract (0 ok/no-op, 1 warn, 2 block, 3 error). No --skip-lint.

Hooks

eventscript
(wired by the installer)guard_origins.py

operator-kit 1.6.2

The harness's operational module: executable gates, governed loops, standalone pass@k/pass^k, audit/enforce policy, preflight, spec-driven planning and two read-only checkers.

Skills

skillwhat it does
adversarial-refuterBefore accepting "done/ready", dispatches read-only refuters that try to KNOCK DOWN the claim against the disk/live source
claude-md-from-profileGenerates the project's CLAUDE.md block FROM operator-profile.yaml - floor first (what the AI does not decide), then where things live, the rules of done and the flow. Idempotent, signed; refuses to overwrite a hand-edited block
delegate-with-handbackDelegates a long/independent task to a 2nd agent with explicit context and a verification gate on the return
doc-consolidator-dedupMerges N overlapping docs/plans into a single deduplicated work-list, archives the superseded ones with a stub-redirect — grep/ls before creating/classifying (LC-3)
dual-report-builderGenerates TWO versions of the same analysis/report — INTERNAL (raw, failures exposed, dark) and EXTERNAL (premium, positive, no failures exposed, light) — as self-contained HTML with pure-CSS charts, print-friendly. The external version goes through a sober-register gate (banned phrases from the profile). Use when producing a report/dashboard with a dual audience (internal team + client/stakeholder).
gate-sheet-collectorDrains everything that depends on the human into ONE form (exact command + what-it-unblocks), without ever blocking the loop
gated-improvement-proposalEvery self-edit of the harness (rule/CLAUDE.md/prompt/hook) becomes a PROPOSAL that passes a gate before being applied — never a sensitive auto-merge
live-source-proverBefore citing ANY number/status/metric, re-derives it at the live source and labels it "live @ HH:MM + source" — never repeats stale data
parallel-dispatchFires independent tasks in waves with a concurrency ceiling + sequential fallback on rate limit
pre-clear-boot-blockBefore a /clear, emits the DONE / MISSING / read-in-this-order block so the fresh session resumes with zero loss
ralph-loop-driverTurns the agent into an autonomous lead engineer — reads charter+work-list, executes until exhausted, self-prompts, stops at the stop-conditions
rls-auditReally audits the RLS of a Supabase project — pg_policies per permissive anon policy + get_advisors, not just the relrowsecurity flag
supabase-edge-scaffoldScaffolds a Supabase Edge Function with correct CORS + service-role + error handling, instead of copying boilerplate by hand

Commands

/cancel-ralph-gate /ralph-gate

Agents

refutador silent-failure-hunter

Hooks

eventscript
PreToolUse · Bashoperation_guard_portable.py
PreToolUse · Bashsnapshot_rollback_gate.py
PreToolUse · Bashexternal_send_draft_gate.py
PreToolUse · Bashfact_force_gate.py
PreToolUse · Edit|Write|MultiEdit|NotebookEditsecret_scan_on_write.py
PreToolUse · Edit|Write|MultiEdit|NotebookEditproject_root_confirm.py
PreToolUse · Edit|Write|MultiEdit|NotebookEditfact_force_gate.py
UserPromptSubmit · *rule_capture.py
Stop · *ralph_gate.py
Stop · *autoprompt_resume.py

Rules

agent-cognition agent-integrity epistemic-standards gateguard learned-corrections loop-cost-budget loop-maker-checker loop-operator loop-passk loop-patterns-catalog no-secrets-in-memory partial-autonomy-slider stale-replay-guard

Templates

loop-charter-template.md

Scripts

audit_plan.py claude_md_from_profile.py debt_ledger.py delta_inventory.py determinism_harness.py distill_corrections.py done_gate.py drift_check.py gate_sheet_panel.py goal_ledger.py goal_review.py health_probe.py live_count.py passk_eval.py preflight.py status_now.py verify_ladder.py

Documents and records

docs/HOOK-SKILL-STANDARDS.md docs/HOOK-SKILL-STANDARDS.pt-BR.md docs/MCP-RUNBOOK.md docs/MCP-RUNBOOK.pt-BR.md docs/RULES-EAGER-BUDGET.md docs/RULES-EAGER-BUDGET.pt-BR.md

continuity-kit 1.4.1

Handoff-v1.1: a session survives a stop/clear/crash without losing its next step. Schema with git-block + re_derive_cmd (every number carries the command that re-derives it live) + verify_first_cmd (check live before replaying any action the handoff describes), Stop/PreCompact/SessionStart hooks. Includes doc-rollup (history/evolution with built-in degradation) + pre-clear (long-term + short-term).

Skills

skillwhat it does
doc-rollupKeeps the project's history/evolution docs (changelog, narrative timeline, state snapshot, lessons, session wrapup) up to date after a significant session — with built-in degradation (a stamp instead of endless narrative) from day 1.
pre-clearBefore a /clear, consolidates the LONG TERM (conditional doc-rollup — how we got here) and the SHORT TERM (handoff — what comes next), then renders the BOOT BUNDLE.

Hooks

eventscript
SessionStart · *handoff_inject.py
Stop · *handoff_guard.py
PreCompact · *handoff_guard.py

Templates

00-DEPLOY.template.md 00-ISOLATION-AND-RECOVERY.template.md 00-PROCESSES.template.md 00-READ-FIRST.template.md 00-ROLLBACK.template.md 00-STATE.template.md 00-VISION.template.md LEARNINGS.template.md loop-charter.template.md settings-continuidade.template.json wave-prd.template.md wave-review.template.md

Scripts

doc_rollup.py state_mirror.py

lane-kit 1.4.1

N sessions without collisions. Lane board, cross-model maker!=checker, per-directory lock, git-guard and territory-guard. The checker_router detects Codex, Cursor and Gemini and picks a provider different from the maker's. Best-of-N: compete/select record which of N competing attempts won.

Skills

skillwhat it does
lane-coordinatorCoordinates N concurrent sessions (lanes) over the same repo through a whiteboard with a state machine (lane_board.py) — from CLAIMED to MERGED, with cross-model maker≠checker enforced in code, not by textual discipline.

Hooks

eventscript
SessionStart · *lane_register.py
PreToolUse · Bashlane_git_guard.py
PreToolUse · Edit|Writelane_territory_guard.py
PostToolUse · *lane_register.py --heartbeat

Templates

lane-registry.example.json lanes.example.yaml REORIENT-MAILBOX.template.md status-stakeholder.template.html

Scripts

checker_router.py lane_board.py lane_effects.py lane_rescue.py

health-kit 1.3.3

Service health probe (http/cmd) driven by profile.yaml + a statusline segment with per-service detail (api:OK db:DOWN), cache-first (the statusline never touches the network). Embedded doctrine: SERVICE health != DATA health. +dashboard-builder (Grafana/SigNoz).

Skills

skillwhat it does
dashboard-builderBuilds monitoring dashboards (Grafana, SigNoz and similar) that answer real operator questions, not "show every metric that exists". Use when turning a list of metrics into a genuinely operable dashboard.
health-checkProbes a config-driven list of services (HTTP or local command) and writes a JSON cache that another tool (e.g. the statusline) can read without touching the network — never on the hot path itself, it only generates the cache.

Hooks

eventscript
SessionStart · *pyrun.sh "${CLAUDE_PLUGIN_ROOT}/scripts/health_probe.py" --quiet

Scripts

gate_sheet_panel.py health_probe.py wire_statusline.py

claude-dev-kit 1.3.3

Tools for building tools: skill-writer, hookify, plugin-dev, teaching, reversible wiring, secret scan, architecture-decision-records, search-first and skill-scout.

Skills

skillwhat it does
architecture-decision-recordsCaptures architectural decisions made during the session as structured ADRs (context, alternatives considered, consequences) in docs/adr/. Use when the user decides between significant alternatives (framework, database, pattern) or asks "why did we choose X?".
claude-dev-setupInstalls the base Claude Code hooks in a new project - idempotent and reversible settings wiring (never overwrites someone else's config without --force) + chain-preserving git hook (never replaces an existing pre-commit hook).
hookifyCreates REAL hooks for Claude Code — executable scripts (stdin JSON, exit 0/1/2), registered via a plugin's hooks.json or pasted into settings.json. Use when the user wants to create a hook, a safety rule, a custom validation, a lifecycle hook.
plugin-devPackages skills/hooks/commands into an installable Claude Code plugin — the real anatomy (.claude-plugin/plugin.json + hooks/hooks.json + ${CLAUDE_PLUGIN_ROOT}), no framework/build step. Use when the user wants to create a plugin, package an extension, or distribute a set of skills/hooks.
search-firstSearches for an existing library/tool/pattern BEFORE writing new code - covers package registries (npm/PyPI), MCP and GitHub, in addition to the local grep. Use before creating a utility, helper, or new integration.
skill-scoutSearches for skills locally, in the marketplace, on GitHub and on the web BEFORE creating a new skill — avoids duplicating work that already exists. Use when the user says "create a skill", "is there a skill for X?", or you are about to suggest creating a new skill.
skill-writerGuides the creation of Agent Skills for Claude Code — structure, frontmatter, effective descriptions, and validation against the SKILL-CONTRACT. Use when the user wants to create, write or structure a new skill.
teachingTurns any technical output (creation, structure, architectural decision) into a learning opportunity - a tree of where the element lives, an x-ray of what-it-is/where-it-sits/what-it-is-for, a connection map, a business analogy, and explained decisions. Always use in technical output for a non-programmer reader.

Hooks

eventscript
PreToolUse · Edit|Write|MultiEditsecret_scan_on_write.py

Scripts

install_git_hook.py wire_settings.py

Documents and records

docs/hook-template.py docs/SKILL-CONTRACT.md docs/SKILL-CONTRACT.pt-BR.md docs/skill-template.md docs/skill-template.pt-BR.md

supabase-pack 1.1.2

rls-audit (real RLS via pg_policies + get_advisors) + supabase-edge-scaffold (TypeScript Edge Function with deno check).

Skills

skillwhat it does
rls-auditAudits a Supabase project's RLS for real — pg_policies per permissive anon policy + get_advisors, not only the relrowsecurity flag
supabase-edge-scaffoldScaffold of a Supabase Edge Function with correct CORS + service-role + error handling, instead of copying boilerplate by hand

agent-framework-wizard 1.2.1

6-step wizard (check_python->check_git->check_deps->configure->validate->generate_and_summary) that scaffolds a new agent/skill. Non-interactive --interview/--answers + --demo; skip-exists with --force.

Skills

skillwhat it does
agent-framework-scaffoldRuns the 6-step wizard that generates the skeleton of a new project (operator-profile.yaml + the chosen templates) — check environment → configure → validate → generate.

Templates

00-PROCESSES.template.md 00-READ-FIRST.template.md 00-STATE.template.md 00-VISION.template.md agents

dev-squad-kit 1.1.1

A squad of 12 roles available as slash commands and real subagents, with explicit tools and read-only QA, plus 3 token-safe parallel reading/consolidation skills. Ships no tasks/templates tree: the role commands that expect one (*create, *task, *workflow) need your own.

Skills

skillwhat it does
pp-consolidateParallel Process Consolidate - consolidates the outputs of parallel sessions/agents into a single, deduplicated, verifiable verdict
pp-discoveryParallel Process Discovery - token-safe inventory of repositories, folders and large artifacts before deep analysis
pp-xrayParallel Process X-Ray - line-by-line reading of an external module/repo with evidence, risks and calls for the next investigation

Commands

/analyst /architect /data-engineer /dev /devops /master /pm /po /qa /sm /squad-creator /ux-design-expert

Agents

analyst architect data-engineer dev devops master pm po qa sm squad-creator ux-design-expert

gotcha-memory 1.0.3

Standalone operational learning loop: a failure becomes knowledge. After every Bash command that fails, the postflight records the event classified by error family; when the same type recurs N times within a window it becomes a GOTCHA -- an actionable lesson the preflight injects BEFORE the next run of the same task. Curated gotchas (your rules) are always-on. Conservative detection: only a clear error signal counts, ambiguous is not a failure. Two WARN-only hooks (always exit 0) -- the learning loop never blocks the flow. stdlib only.

Skills

skillwhat it does
gotcha-memoryOperational learning loop — records command failures, detects recurrence and injects the lesson as a preamble before the next execution of the same task. Use to query/seed/debug the project's gotcha memory.

Hooks

eventscript
PreToolUse · Bashgotcha_preflight.py
PostToolUse · Bashgotcha_postflight.py
PostToolUseFailure · Bashgotcha_postflight.py