Speq Audit

Alleen-lezen gezondheidsaudit voor speq spec libraries met gated fixes

Door marconae · marconae/speq-skill

Werkt met setup ★ 8.0/10

Speq Audit — Alleen-lezen gezondheidsaudit voor speq spec libraries met gated fixes

Wat het doet

Auditeert de gezondheid van een speq-project aan de hand van 12 alleen-lezen controles: spec-library structuur, feature/decision-log/plan validatie, mission-to-spec sync, onopgenomen plannen en gitignore hygiëne, en biedt vervolgens aan om elke bevinding één voor één te repareren. Activeert wanneer u vraagt om de specs of repo te auditen, health-checken, dokteren, linten of sanity-checken, of na het klonen of overnemen van een speq-project.

Testrapport

Voerde de alleen-lezen controles live uit op de eigen repo van de skill en het ving echte problemen: cli/plan-validate bevat 15 scenario's (boven de drempel van 10) en het cli-domein bevat 12 features (boven 8), naast een schone gitignore en schone git-status. Het is een echt alleen-lezen orchestrator waarbij elke remediëring wordt afgeschermd door een expliciet Ja. Wrijving: vier van de twaalf controles roepen de speq Rust CLI aan (feature/decision-log/plan validate) plus een mission-sync sub-agent, waarvan geen enkele zelfstandig draait zonder het bouwen van de binary en het installeren van de bijbehorende speq-cli en speq-writing-guardrails skills. De numerieke-drempel checklist versloeg een ad-hoc review, maar een derde van de controles was alleen onmeetbaar.

Getest op: 2026-07-24 · Claude Code 2.x (agent harness)

Installatie

git clone https://github.com/marconae/speq-skill
mkdir -p ~/.claude/skills
cd speq-skill && cp -r .claude/skills/speq-audit ~/.claude/skills/speq-audit

Commando's en voorbeeldprompts

  • /speq-auditAlleen-lezen gezondheidsaudit voor speq spec libraries met gated fixes

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Audit the health of our speq spec library and report issues
  • Doctor-check this repo's specs after I just cloned it
  • Lint the feature and decision logs for sync issues