--- name: bamboohr-local-dev-loop-30cc966af01a description: >- Create a fast BambooHR development loop with synthetic fixtures, a recording- free fake transport, contract tests, and opt-in test-tenant reads. Use when developing safely without copying employee data onto laptops. Trigger with "BambooHR local dev", "mock BambooHR", or "BambooHR test fixtures". allowed-tools: Read,Glob,Grep,Write,Edit argument-hint: " " version: 1.5.0 license: MIT author: Jeremy Longshore tags: [saas, hr, bamboohr, local-development, testing] model: inherit effort: high compatibility: Designed for Claude Code --- # BambooHR Local Development Loop ## Overview Make local iteration independent of production HR data and network availability. Use a fake transport whose fixtures are designed from the official schema, not recorded from real employees. ## 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 The official OpenAPI and SDK docs define operations, status codes, auth modes, pagination, and typed errors. They are suitable inputs for contract fixtures; they do not authorize copying actual BambooHR payloads into a repository. ## Authentication Default local configuration uses obvious non-secret placeholders and a fake transport. A live test-tenant profile is separate, ignored by version control, loaded from an approved secret store, and never activated by ordinary test or watch commands. ## Instructions 1. Inspect runtime, package manager, test framework, local configuration, and current BambooHR adapter. 2. Put a transport interface behind the adapter. Implement an in-memory fake with explicit scripted responses and request assertions. 3. Create synthetic employees and HR objects with impossible domains and values. Cover active/inactive/future states, missing permitted fields, pagination, empty results, and schema drift without realistic government IDs or records. 4. Add scenarios for `401`, `403`, `409`, `412`, `413`, `422`, `429`, `503`, `504`, `598`, timeout, redaction, request IDs, and ambiguous mutation outcome. 5. Add a watch command that runs offline unit/contract tests only. Keep any integration test behind an explicit profile and approval gate. 6. For webhook development, generate payloads locally, verify raw-byte HMAC behavior with a synthetic key, and test replay/idempotency. Do not capture a real delivery as a fixture. 7. Document reset, seeded scenarios, schema-pin update, and the exact command that proves the default loop performs no network calls. ## Tool Discipline Use Read, Glob, and Grep to inspect code and ignored paths. Use Write/Edit for approved fake transport, fixtures, tests, and developer docs. Do not install packages or access BambooHR under this skill. ## Approval Boundaries Require approval before adding a dependency, storing any live credential, calling a tenant, capturing traffic, or adding a fixture derived from customer data. Redaction does not automatically make a production payload reusable. ## Output Return transport boundary, scenario inventory, fixture provenance, commands, no-network proof, coverage for auth/retry/pagination/webhooks, test results, and any optional live profile that remains disabled. ## Error Handling - Test attempts network access: fail the suite and identify the unmocked operation. - Fixture resembles real HR data: remove it and replace with synthetic values. - Fake diverges from pinned OpenAPI: update through a reviewed contract diff. ## Examples - "Record production responses for tests" is rejected in favor of synthetic fixtures. - "Make BambooHR tests fast" yields an offline fake plus targeted contract tests. ## Resources Read [official evidence](references/official-docs.md) when designing scenarios. --- Source attribution: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/bamboohr-pack/skills/bamboohr-local-dev-loop/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2025 Jeremy Longshore Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/bamboohr-pack/skills/bamboohr-local-dev-loop/SKILL.md Attribution basis: Source repository record Fields of work: Human Resources, Product Management Roles: HR Generalist, Product Manager Specialties: API, Backend Tools: Bamboohr Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: ef62686f918575c78494dbfe88d79e0b68a2155cec3ad625e5796082941b5efd