Skip to content

feat: give coding agents a guideline and point a failure at the test line - #4

Merged
sorge-it merged 1 commit into
mainfrom
feat/agent-guidelines
Oct 6, 2026
Merged

sorge-it merged 1 commit into
mainfrom
feat/agent-guidelines

Conversation

@sorge-it

@sorge-it sorge-it commented Oct 6, 2026

Copy link
Copy Markdown
Owner

What changes

  • A failure points at the line of the test. Before, Pest showed a line in src/PHPUnit/Assertion.php. The package now adds its src directory to PHPUnit's ExcludeList, as PHPUnit does with its own code. HTML_ASSERTIONS_SHOW_FRAMES=1 in the shell keeps the frames, for a bug report. The checkout of the package keeps them always.
  • Coding agents get the rules: a guideline for Laravel Boost (resources/boost/guidelines/core.blade.php), the skill as a Claude Code plugin of this repository, and npx skills add for other agents.
  • A recorded demo in the README, made with VHS from the app in demo/. A new CI step runs that app on all three stacks: PHPStan reports the string check, and Pest shows the test line and no frame of the package.
  • Contributing: issues close; a problem comes as a pull request. A vulnerability is reported through GitHub's private advisories.
  • Requires Composer 2.1 (composer-runtime-api: ^2.1).

Checked

  • composer test on PHP 8.3 (PHPUnit 12, Pest 4, Laravel 12, Symfony 7.4) and PHP 8.5 (lock): 219 tests, PHPStan max, type coverage 100 %.
  • Three mutations of StackTrace::hide() each turn a test red.
  • claude plugin validate . passes; npx skills add --list finds the skill.

See CHANGELOG.md, section 1.4.0.

…line

A Boost guideline, a Claude Code plugin and the skills CLI bring the skill to agents. PHPUnit's ExcludeList hides the package's frames, so Pest shows the test line. Requires Composer 2.1. A recorded demo, contribution and security policies.
@sorge-it
sorge-it force-pushed the feat/agent-guidelines branch from d1b6ddc to 7bdf7b9 Compare October 6, 2026 15:01
@sorge-it
sorge-it merged commit a4dd98e into main Oct 6, 2026
3 checks passed
@sorge-it
sorge-it deleted the feat/agent-guidelines branch October 6, 2026 15:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant