run-api

Validate HanapBahay AI domain logic without booting Laravel.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/rgvalguna/hanapbahayai --skill run-api
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-api
Source: https://github.com/rgvalguna/hanapbahayai/tree/main/api/.claude/skills/run-api
Command: npx skills add https://github.com/rgvalguna/hanapbahayai --skill run-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate core domain logic for HanapBahay AI without booting the full Laravel app. This skill provides a lightweight path to exercise domain math in isolation, ensuring correctness before full integration.

Core Features & Use Cases

  • Exercise Amortization, PagIBIG, DTIEngine, BankFinancing, and HiddenCosts with representative inputs to verify calculations.
  • Lightweight smoke tests suitable for PR checks and CI to catch regressions in domain logic.
  • Uses a minimal PSR-4 autoloader and a standalone smoke driver to run domain tests without Laravel or a vendor stack.

Quick Start

Run the smoke script to execute all domain checks against the PHP domain logic in api/.claude/skills/run-api/smoke.php.

Frequently Asked Questions about run-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I smoke-test PHP backend domain logic without booting the full Laravel application?▼

You can smoke-test PHP domain logic without Laravel by using a minimal PSR-4 autoloader and a standalone driver to exercise core calculations like Amortization and HiddenCosts in isolation.

What is the best way to run smoke tests for domain logic calculations in a CI pipeline?▼

The best way to run smoke tests for domain logic in CI is executing a standalone PHP script that validates representative inputs for modules like BankFinancing and DTIEngine, catching regressions without vendor overhead.

Can I validate Amortization and PagIBIG calculations without a full framework installation?▼

Yes, you can validate Amortization and PagIBIG calculations without a full framework by running a framework-free testing workflow that exercises domain math directly through representative inputs.

Does this smoke testing approach work for PR checks on PHP repositories?▼

Yes, this smoke testing approach works for PR checks by providing lightweight domain validation that exercises DTIEngine and HiddenCosts logic quickly without booting the full application stack.

Why should I use a standalone smoke driver instead of full integration tests for domain logic?▼

You should use a standalone smoke driver instead of full integration tests to verify domain math in isolation, ensuring calculation correctness quickly without booting the entire Laravel application or vendor stack.