Symfony Rigor Kit: Traceable Specs and Golden Tests

    1

    Turn business rules into traceable specifications and golden-file tests in Symfony/PHP repositories, with portable agent workflows and optional quality checks.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Symfony Rigor Kit: Traceable Specs and Golden Tests

    Example session with this skill installed

    Set up the essential Symfony Rigor Kit in a small PHP test repository, using only the Codex integration. Add a traceable specification for 2 + 2 = 4, implement its PHPUnit test, and run the verifier. Confirm that the Stop hook blocks an intentionally failing assertion, then restore the test and verify that it passes.

    • Read your context and instructions
    • Compiled the symfony rigor kit

    Local validation example

    This reproducible example comes from a small Windows/PowerShell validation fixture. It is not a production project or a session executed through Agensi MCP.

    Essential setup

    php vendor/bin/rigor instalar --perfil=essencial --agentes=codex
    

    The setup created the module catalog, the traceability test, AGENTS.md, the three portable skills and the selected Codex hook. Composer scripts were configured separately for the fixture; no mutation testing or architecture checks were enabled.

    Specification

    
    ## Regras
    
    ### SMK-01 A soma de dois com dois resulta em quatro
    
    - **Dado** dois e dois, **quando** soma, **então** retorna 4.
    

    Test

    <?php
    namespace App\Tests;
    use PHPUnit\Framework\TestCase;
    use PHPUnit\Framework\Attributes\Group;
    
    final class SmokeTest extends TestCase
    {
        #[Group('SMK-01')]
        public function testSoma(): void
        {
            self::assertSame(4, 2 + 2);
        }
    }
    

    Actual PHPUnit output after restoring the correct assertion

    PHPUnit 13.4.6 by Sebastian Bergmann and contributors.
    
    Runtime:       PHP 8.5.12
    
    .......                                                             7 / 7 (100%)
    
    Time: 00:00.020, Memory: 20.00 MB
    
    OK (7 tests, 7 assertions)
    

    The assertion was deliberately changed to expect 5. The hook returned a blocking decision. After restoring 4, the verifier returned:

    rigor-verificar: composer check:rapido...
    rigor-verificar: verde em 3 s.
    

    Next steps

    Replace the toy rule with approved business scenarios. Review the assertions and golden-file differences. Keep the full CI check independent of agent hooks, and add optional checks only when the project adopts them. A traceability reference alone does not prove a business rule is correctly tested.

    created the module catalog, the traceability test, AGENTS.md

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Keep specifications, tests and generated outputs connected

    This free pack includes three Agent Skills for Symfony/PHP repositories:

    • rigor-instalar: install or update the Composer kit and configure an essential or complete profile for your project.
    • rigor-spec: write business rules with stable IDs and concrete Dado/quando/então scenarios, obtain approval for the specification, then implement and test the approved behavior.
    • rigor-mutacao: run and interpret Infection mutation tests when requested or already enabled by the project.

    Start with traceable specs and golden-file tests. Adopt architecture rules, coverage gates, mutation testing and CI templates only when they fit your project. Preserve your existing architecture, asset bundler, analysis level and test runner.

    Requirements and compatibility

    Requires PHP 8.4+, Composer 2.2+, Git, compatibility with PHPUnit 12/13, and a coding agent with repository and terminal access. The library is installed separately as christopherpersaud/kit-rigor-symfony:^0.4. Installation needs network access. Infection and a coverage driver are needed only for mutation testing.

    The skills use the open Agent Skills format and can guide compatible agents including Claude Code, Codex, Cursor, Copilot CLI, Gemini CLI and OpenCode, subject to their tools and permissions. Optional Stop hooks integrate with Claude Code and Codex. In other harnesses, run the verifier explicitly. CI covers Ubuntu and Windows with PHP 8.4/8.5; complete sessions have not been certified in every agent.

    Delivery and limits

    Agensi delivers the instructions through MCP. Composer installs the executable library and project templates into your repository; do not run its entrypoints as isolated temporary MCP scripts. No paid Agensi tools or external API keys are required.

    Instructions, runtime messages and specification conventions include Brazilian Portuguese. Traceability checks IDs and test references; it does not prove the correctness of assertions or complete coverage of every scenario. Human review remains necessary.

    Requires a PHP repository, Composer and terminal access; executable code is installed separately with Composer. Agent tools and permissions vary. Optional Stop hooks target Claude Code and Codex; use explicit verification in other harnesses. CI covers Windows/Linux, not complete sessions in every agent. Includes Brazilian Portuguese. Traceability does not prove assertion quality or complete scenario coverage.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 10 days ago

    • Free with an Agensi account

    Requires

    PHP 8.4+
    Composer 2.2+
    Git
    PHPUnit 12 or 13
    christopherpersaud/kit-rigor-symfony

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Network Access
    Environment Variables

    File Scopes

    src/**
    tests/**
    docs/**
    composer.*
    .agents/**
    .claude/**
    .codex/**
    .github/**
    AGENTS.md
    templates/**
    assets/**
    var/**
    CLAUDE.md
    GEMINI.md

    Runs Composer and project checks locally; reads and edits the target repository, specifications, tests and selected agent configuration. Network access is used for package installation and Git fetch. Environment variables configure local test/coverage runs and golden-file updates. No paid Agensi tools or external API keys are required. Do not upload project secrets or credentials to the marketplace.

    Listed10 days ago

    What's inside

    Frequently Asked Questions

    It links stable specification IDs to test references and provides golden-file helpers and optional checks. Traceability does not prove that assertions are correct or that every scenario is covered. Human review and meaningful tests remain necessary.

    PHP 8.4+, Composer 2.2+, Git and PHPUnit 12/13 compatibility, plus an agent with repository and terminal access. Install christopherpersaud/kit-rigor-symfony:^0.4 separately. Infection and pcov/Xdebug are only needed for mutation testing.

    Start with rigor-instalar and the essential profile. Review the proposed changes and preserve the existing architecture, bundler, test runner and analysis level. Architecture checks, coverage, mutation testing and CI templates are optional additions.

    Three portable Agent Skills: rigor-instalar, rigor-spec and rigor-mutacao. Agensi supplies instructions through MCP; Composer installs the executable library and templates. No paid Agensi tools or external API keys are required.

    The open SKILL.md format supports compatible coding agents with the needed tools and permissions. Optional Stop hooks target Claude Code and Codex; other harnesses must run verification explicitly. Full sessions have not been certified in every agent.

    Golden-file helpers compare outputs such as XML, JSON and HTML against reviewed expected files. The listing is in English; skill instructions, runtime messages and specification conventions include Brazilian Portuguese.

    New in Testing & Debugging