Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

bamboohr-reference-architecture

/bamboohr-reference-architecture

Projektuje wielotenantowy konektor BambooHR z jasnymi granicami uwierzytelniania, ingestii, webhooków, kolejek, składowania, uzgadniania i audytu.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Projektuje wielotenantowy konektor BambooHR z jasnymi granicami uwierzytelniania, ingestii, webhooków, kolejek, składowania, uzgadniania i audytu.

Wyzwalacze z opisu

BambooHR architectureBambooHR system designmulti-tenant BambooHR connector

Argumenty

/bamboohr-reference-architecture <integration-scope> <single-tenant|multi-tenant>
Oryginalny opis (EN)

Design a multi-tenant BambooHR connector with explicit auth, ingestion, webhook, queue, storage, destination, reconciliation, and audit boundaries. Use when creating or reviewing production HR integration architecture. Trigger with "BambooHR architecture", "BambooHR system design", or "multi-tenant BambooHR connector".

Jak działa

  1. Overview
  2. Prerequisites
  3. Current Contract
  4. Authentication
  5. Instructions
  6. Tool Discipline
  7. Approval Boundaries
  8. Output
  9. Error Handling
  10. Examples
Sekcje z nagłówków SKILL.md, w oryginale · 84 linii, 510 słów
Podgląd SKILL.md
---
name: bamboohr-reference-architecture
description: >-
  Design a multi-tenant BambooHR connector with explicit auth, ingestion,
  webhook, queue, storage, destination, reconciliation, and audit boundaries.
  Use when creating or reviewing production HR integration architecture.
  Trigger with "BambooHR architecture", "BambooHR system design", or
  "multi-tenant BambooHR connector".
allowed-tools: Read,Glob,Grep,Write,Edit
argument-hint: "<integration-scope> <single-tenant|multi-tenant>"
version: 1.5.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags: [saas, hr, bamboohr, architecture, multi-tenant]
model: inherit
effort: high
compatibility: Designed for Claude Code
---
# BambooHR Reference Architecture

## Overview

Produce an architecture that keeps control-plane actions, HR data-plane reads,
mutations, webhook reception, and downstream delivery independently governable.
The connector is not the authority for HR policy; BambooHR and the approved
destination each retain explicit ownership.

## Prerequisites

- The target repository or integration path and the requested operator outcome.
- The tenant, identity, and data scope only when approved live work is in scope.
- The current evidence register plus customer-specific permissions and agreements.

## Current Contract

Use tenant-local BambooHR hosts and current official OpenAPI operations. Prefer
dataset v2 for new bulk reads. Support OAuth token refresh with external
persistence, typed request IDs/errors, bounded retries, and webhook one-time key
custody. Treat deprecated report/dataset v1 paths as migration boundaries.

## Authentication

The control plane stores encrypted, tenant-scoped credential metadata and exact
redirect/permission configuration. Workers receive short-lived access to one
tenant credential; they cannot choose arbitrary hosts or read another tenant's
tokens. API-key mode uses a dedicated BambooHR identity and explicit rotation.

## Instructions

1. Define actors, tenants, business outcomes, systems of record, fields,
   workflows, freshness, scale, residency, retention, and recovery objectives.
2. Draw trust boundaries among consent/callback, token store, scheduler, sync
   worker, webhook ingress, queue, schema validator, destination adapter,
   checkpoint store, audit log, monitoring, and support tooling.
3. Separate read and mutation workers and permissions. Route jobs with an
   immutable tenant ID resolved to trusted credential and destination metadata.
4. For scheduled sync, use minimized dataset v2 reads, deterministic pagination,
   transactional checkpoints, idempotent destination upsert, and periodic full
   reconciliation.
5. For webhooks, terminate TLS, retain raw bytes only in memory for verified
   HMAC, reject replay, enqueue idempotently, acknowledge promptly, and use the
   event only as a trigger for an authorized source read when appropriate.
6. Enforce field allowlists and schema versions before queues/storage. Encrypt
   approved HR data and keep bodies out of general logs, traces, and dead letters.
7. Add per-tenant concurrency, finite retries, circuit breaker, dead-letter
   review, request-ID correlation, and backpressure.
8. Design credential revocation, tenant offboarding, data deletion, webhook
   replacement, schema migration, regional failure, and rollback before launch.

## Tool Discipline

Use Read, Glob, and Grep to ground the design in the existing system. Use
Write/Edit only for approved architecture records, diagrams-as-code, and
interface contracts. This skill does not provision or mutate infrastructure.

## Approval Boundaries

Require approval for field and workflow scope, auth model, tenant routing,
regions, retention, destination authority, webhook events, mutation path, and
recovery objectives. Record unresolved decisions rather than guessing.

## Output

Return context/container/component views, data flows and trust boundaries,
identity/permission matrix, field contract, queue/checkpoint/idempotency model,
failure paths, SLOs, retention/deletion, decisions, risks, and validation plan.

## Error Handling

- Unknown system of record: stop write-path design until ownership is resolved.
- Shared tenant credential/destination namespace: classify as a blocking isolation risk.
- No reconciliation or rollback model: architecture is not production-ready.

## Examples

- "Design employee sync" yields both scheduled reconciliation and webhook trigger paths.
- "Use one admin key for all customers" is rejected at the tenant trust boundary.

## Resources

Read [official evidence](references/official-docs.md) before finalizing interfaces.
Pliki w paczce (2)
  • SKILL.md 5 KB
  • references/official-docs.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie bamboohr-reference-architecture.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 3d3236273d34 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100bamboohr-prod-checklist
    Podejmuje decyzję go/no-go dla konektora BambooHR na podstawie dowodów o uwierzytelnianiu, izolacji tenantów, obsłudze danych HR, niezawodności, uzgadnianiu, monitoringu i rollbacku.
  • 100bamboohr-install-auth
    Wybiera i konfiguruje uwierzytelnianie BambooHR przez OAuth 2.0 lub klucz API bez ujawniania poświadczeń HR.
  • 100bamboohr-webhooks
    Odbiera i weryfikuje webhooki BambooHR, zdarzenia pracowników i firm oraz podpis X-BambooHR-Signature przy błędach.
  • 100bamboohr
    Integruje BambooHR przez zunifikowane API HRIS Apideck: odczyt i synchronizacja pracowników, działów, list płac i urlopów, z przełączaniem konektora przez serviceId.
  • 100bamboohr
    Czyta i synchronizuje pracowników, działy, listy płac i urlopy w BambooHR przez ujednolicone API Apideck.
  • 100multi-tenant-saas-architecture
    Pomaga projektować izolację tenantów, granice paneli, autoryzację zero trust, ślady audytu i nadpisywanie uprawnień tenantów w architekturze SaaS.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.