holepunch-app-composition

Compose a complete Holepunch application by assigning responsibilities across the host shell, Pear runtime, backend worker, shared domain layer, RPC boundary, and UI state. Use for tasks that plan or refactor app architecture, decide where features should live, connect Hyperstack primitives to Pear hosts, or turn a product idea into a practical implementation blueprint without coupling it to one specific app.

Ir para a instalação

Repositório: mikker/holepunch-skills
Última atividade na origem: 25 de março de 2026 às 12:05
Idioma detectado do SKILL.md: inglês
Estrelas: 1
Forks: 0

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/mikker/holepunch-skills --skill holepunch-app-composition

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

Explorador de arquivos

4 arquivos

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

autobonk-contexts

Define schema-first Autobonk domains with generated schema bundles, `Hyperdb` views, managers, contexts, role-based permissions, pairing flows, and optional Yjs collaboration support through `autobonk-yjs`. Use for tasks that model shared state, write or extend `schema.js`, add routes and permission checks, build create/join flows, or implement deterministic replicated collaboration on top of Autobonk.

2026-03-25

hyperstack-foundations

Design and implement peer-to-peer application backends on the Holepunch hyper stack using Corestore, Hyperswarm, Autobase, Hyperbee, Hyperdb, Hyperblobs, Hyperdrive, and adjacent storage primitives. Use for tasks that need storage topology decisions, local-versus-shared state boundaries, replication design, lifecycle and cleanup planning, or backend architecture for a worker, service, or app core.

2026-03-25

pear-v2-runtime

Build and wire Pear v2 applications using the current template-plus-runtime approach, especially `hello-pear-*` starters, `pear-runtime`, `pear-mobile`, embedded Bare workers, explicit storage paths, and OTA update flow. Use for tasks that bootstrap a new Pear app, wire an Electron or mobile host, add update handling, separate dev and packaged behavior, or define staging and release flow.

2026-03-25

Ver todas deste repositório

Holepunch App Composition

Overview

Use this when the problem is bigger than one library. The goal is to produce a clean architecture where the runtime boots the worker, the worker owns replication, the domain layer owns rules, and the UI consumes snapshots.

Preferred Shape

Host shell: windowing, preload bridge, runtime lifecycle, update events.

Worker or service: long-lived backend, managers, watchers, snapshots, file ingestion.

Domain layer: contexts, schemas, permissions, replicated data model.

UI layer: state store, optimistic UX where safe, rendering only.

Architectural Rules

Keep app-specific business rules out of the host shell.

Do not let the renderer talk to Corestore or Hyperswarm directly if a worker can own that state.

Build one RPC surface per worker and keep it task-oriented, not storage-oriented.

Let the worker stream snapshots or events to the UI instead of exposing many low-level queries.

Compose in This Order

Define the replicated domain and local metadata split.

Choose the host and runtime wiring.

Define the worker entrypoint and ownership of managers and watchers.

Define the RPC surface the UI actually needs.

Shape the UI around snapshots, subscriptions, and task-level mutations.

Add test seams at the worker and domain boundaries first.

Load References When Needed

Read references/blueprint.md for the recommended layer boundaries and build order.

Read references/examples.md for example architectures that have already proven workable.

name

holepunch-app-composition

description