# Problem-Based SRS

[](https://github.com/RafaelGorski/Problem-Based-SRS/releases) [](https://rafaelgorski.github.io/Problem-Based-SRS/skills-health.html) [](https://agentskills.io) [](https://opensource.org/licenses/MIT)

**Problem-Based SRS is a plugin that extends your AI harness to handle Software Specifications.** It plugs into GitHub Copilot first — and Claude Code and other AI coding assistants too — turning a general-purpose coding agent into one that can reason about, trace, and evolve requirements instead of just emitting code.

On top of your harness, the plugin adds three things:

| | What it adds | |---|--------------| | 🛡️ **AI‑slop prevention** | Guardrails tuned to the specific model that stop the agent from inventing features, skipping steps, or drifting off the actual problem. | | 🧭 **A spec language + command palette** | A shared vocabulary (Business Context → CP → CN → FR) and a `/problem-based-srs` command set that steer you toward great design, one decision at a time. | | 🌱 **A method for brownfield *and* greenfield** | A rigorous way to evolve existing systems (learn a spec from the code you inherited) as well as specify new ones from scratch. |

It traces every feature back to the customer problem it solves, using the [AgentSkills](https://agentskills.io) open standard.

**Don't take the anti-drift claim on faith — audit it.** Every push runs four suites (plugin validation, canvas unit tests, deterministic skill evals, and a Playwright visual suite) and publishes the result to the [**Skills Health Dashboard**](https://rafaelgorski.github.io/Problem-Based-SRS/skills-health.html). The snapshot is regenerated by `pwsh run-tests.ps1` and committ