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.