ReddRadar
Agent skill
integration-rules
Ultra Builder Pro system integration rules
Install this agent skill to your Project
npx add-skill https://github.com/rocky2431/ultra-builder-pro/tree/main/skills/integration-rules
SKILL.md
Integration Rules
These rules are mandatory for all code review and development work involving multi-component systems.
Vertical Slice Principle
Every task MUST deliver a thin, working end-to-end path:
| Good (Vertical Slice) | Bad (Horizontal Layer) |
|---|---|
| "User can send message" (UI + API + LLM + response display) | "Create all database tables" |
| "Display product list" (API call + domain filter + UI render) | "Build all API endpoints" |
| "Process payment" (UI form + gateway + order update) | "Create all UI components" |
Walking Skeleton
The FIRST deliverable of any multi-component feature must be a walking skeleton:
- One request flows through ALL layers
- Returns real data (not hardcoded/mocked)
- Proves the architecture connects end-to-end
- Does NOT need to be feature-complete — just connected
Contract-First Development
When two components will communicate:
| Step | Action | Artifact |
|---|---|---|
| 1 | Define interface before implementation | TypeScript interface, OpenAPI schema, or protobuf |
| 2 | Both sides code against the contract | Import shared types or generated clients |
| 3 | Contract test validates both sides | Test that producer output matches consumer expectation |
Integration Test Requirements
| Boundary | Required Test |
|---|---|
| HTTP API endpoint | Request with real HTTP client, validate response shape + status |
| Database operation | Testcontainers with real queries, validate data persisted |
| Message queue | Real producer + consumer, validate message delivered |
| External service | Test Double with // Test Double rationale: (only exception) |
| In-process module boundary | Real function call, validate input/output contract |
Orphan Detection
Code without a live entry point is dead-on-arrival.
Valid entry points (at least one required per new module):
- HTTP/WebSocket handler
- CLI command handler
- Event/message listener
- Scheduled job/cron handler
- Exported function called by a module that has an entry point
Detection: Trace from new code upward — if no path reaches an entry point, the code is an orphan.
Detection Checklist
When reviewing code, flag:
- New module/service without any caller (orphan code)
- Task structured as horizontal layer instead of vertical slice
- Two components communicating without shared interface/contract
- New boundary crossing without integration test
- Use case with DB/API dependency but only unit tests
- Component "works in isolation" but not wired to any entry point
- Interface defined but no contract test validating compatibility
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
rocky2431/ultra-builder-pro
vercel-composition-patterns
React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.
rocky2431/ultra-builder-pro
recall
Search and manage cross-session memory. Query past sessions by keyword, semantic similarity, or hybrid search. Save summaries and tags for future recall.
rocky2431/ultra-builder-pro
code-review-expert
Structured code review checklists: SOLID, security, performance, boundary conditions, removal planning. Injected into code-reviewer agent.
rocky2431/ultra-builder-pro
use-railway
Operate Railway infrastructure: create projects, provision services and databases, deploy code, configure environments and variables, manage domains, troubleshoot failures, check status and metrics, and query Railway docs. Use this skill whenever the user mentions Railway, deployments, services, environments, build failures, or infrastructure operations, even if they don't say "Railway" explicitly.
rocky2431/ultra-builder-pro
security-rules
Ultra Builder Pro security rules
rocky2431/ultra-builder-pro
ai-collab-base
Shared collaboration protocol, modes, and prompt templates for AI collab skills. Consumed by gemini-collab, codex-collab, and ultra-verify as a shared foundation.
Didn't find tool you were looking for?