Skip to content
Back to search

laravel-logic-trace-tests

Agent Skill: Laravel tests from evidence. Traces request flow, probes edge cases, records CURRENT vs RECOMMENDED behavior

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/suliman-al-helou--laravel-logic-trace-tests/badge.svg)](/listings/suliman-al-helou--laravel-logic-trace-tests)

HTML

<a href="/listings/suliman-al-helou--laravel-logic-trace-tests"><img src="/api/listings/suliman-al-helou--laravel-logic-trace-tests/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Replace ` Suliman-Al-Helou` with the account that hosts this repo.

**Gemini CLI**

gemini skills install https://github.com/ Suliman-Al-Helou/laravel-logic-trace-tests.git \
  --path skills/laravel-logic-trace-tests --scope workspace --consent

**Any agent that supports `npx skills`**

npx skills add  Suliman-Al-Helou/laravel-logic-trace-tests --skill laravel-logic-trace-tests

**Claude Code (manual)**

git clone --depth 1 https://github.com/ Suliman-Al-Helou/laravel-logic-trace-tests.git /tmp/lltt
mkdir -p .claude/skills && cp -r /tmp/lltt/skills/laravel-logic-trace-tests .claude/skills/

**Laravel Boost**

mkdir -p .ai/skills && cp -r /tmp/lltt/skills/laravel-logic-trace-tests .ai/skills/
php artisan boost:update

Copy the whole folder: the scripts and references live beside `SKILL.md`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 105 lines
  1. # laravel-logic-trace-tests
  2. An [Agent Skill](https://github.com/anthropics/skills) for Laravel/PHP back-end tests that are built
  3. from **evidence**, not guesses.
  4. It makes the agent trace the real request flow (route → middleware → FormRequest → controller →
  5. service → model → events/jobs → policy), find edge cases by reading the code and running probes,
  6. and then write tests that pin the **current** behavior and state the **recommended** behavior with
  7. a one-line reason.
  8. ## What you get
  9. For each edge case, a comment block above the test (checked by a gate script):
  10. ```php
  11. // EDGE: E-03
  12. // COVERS: D-07
  13. // CURRENT: second identical POST returns 201 and creates a duplicate order
  14. // RECOMMENDED: 409 and no duplicate (precedent: app/Http/Controllers/PaymentController.php:58)
  15. // WHY: client retries after a timeout would double charge
  16. // EVIDENCE: app/Services/OrderService.php:42 ; probe P-03
  17. ```
  18. Plus `.trace/logic-map.md`, `.trace/decision-table.md`, `.trace/probes/*.json` and
  19. `.trace/behavior-report.md`.
  20. ## Rules the skill enforces
  21. 1. No edge case without a `file.php:line` the agent opened and a probe result it actually ran.
  22. 2. `RECOMMENDED` comes from a project precedent or Laravel docs, otherwise `none established`.
  23. 3. Application code is never modified. Only `tests/` and `.trace/`.
  24. 4. Probes run through the test runner only (test DB), never against the default environment.
  25. 5. A gate script fails the run on incomplete edge blocks, missing evidence, assertion-less tests,
  26. and uncovered decision-table rows.
  27. Designed to stay usable with small/cheap models: short `SKILL.md`, one phase per reference file,
  28. mechanical checks instead of prose rules.
  29. ## Install
  30. Replace ` Suliman-Al-Helou` with the account that hosts this repo.
  31. **Gemini CLI**
  32. ```bash
  33. gemini skills install https://github.com/ Suliman-Al-Helou/laravel-logic-trace-tests.git \
  34. --path skills/laravel-logic-trace-tests --scope workspace --consent
  35. ```
  36. **Any agent that supports `npx skills`**
  37. ```bash
  38. npx skills add Suliman-Al-Helou/laravel-logic-trace-tests --skill laravel-logic-trace-tests
  39. ```
  40. **Claude Code (manual)**
  41. ```bash
  42. git clone --depth 1 https://github.com/ Suliman-Al-Helou/laravel-logic-trace-tests.git /tmp/lltt
  43. mkdir -p .claude/skills && cp -r /tmp/lltt/skills/laravel-logic-trace-tests .claude/skills/
  44. ```
  45. **Laravel Boost**
  46. ```bash
  47. mkdir -p .ai/skills && cp -r /tmp/lltt/skills/laravel-logic-trace-tests .ai/skills/
  48. php artisan boost:update
  49. ```
  50. Copy the whole folder: the scripts and references live beside `SKILL.md`.
  51. ## Use
  52. Run from the Laravel project root and name ONE feature or endpoint:
  53. > Write tests for `POST /api/orders`. Use the laravel-logic-trace-tests skill.
  54. ## Requirements
  55. - Laravel project with Pest or PHPUnit and a configured test database
  56. - `bash`, `php`, `python3` on PATH
  57. ## What the scripts do (read before installing)
  58. - `scripts/detect_env.sh` — read-only: runs `php artisan --version`, greps `phpunit.xml` / `composer.json`,
  59. counts test files, writes `.trace/env.txt`.
  60. - `scripts/verify_tests.py` — static checks over `tests/` and `.trace/`. With `--run` it executes
  61. `php artisan test`.
  62. - The skill declares no `allowed-tools`.
  63. ## Known limitations (v0.1.0)
  64. - Not yet evaluated on multiple models; compliance of cheap models is unmeasured.
  65. - The gate is regex-based and can miss unusual test layouts (data providers, dynamic tests).
  66. - The gate does not yet reject a `RECOMMENDED` precedent that points at the same line as `EVIDENCE`
  67. (circular evidence).
  68. - The gate does not detect gaps in edge IDs (an edge dropped without being reported as UNVERIFIED).
  69. - Speed: probes and full-suite runs can make a run take several minutes.
  70. ## Roadmap
  71. - Circular-evidence check in the gate
  72. - Edge-ID continuity check
  73. - Batched probes and focused test runs
  74. - Evals with with-skill vs without-skill runs on a small model
  75. ## License
  76. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.