faffter-noon-evaluate

Evaluates a running feature against a spec's done-criteria without reading the codebase.

3|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/shftwst/faff --skill faffter-noon-evaluate-shftwst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: faffter-noon-evaluate
Source: https://github.com/shftwst/faff/tree/main/plugin/skills/faffter-noon-evaluate
Command: npx skills add https://github.com/shftwst/faff --skill faffter-noon-evaluate-shftwst

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers whether a running feature actually satisfies what its spec promised, without trusting the builder's own tests or being influenced by the implementation. By judging only the live system against the spec's definition of done, it produces an independent, code-blind verdict that a merge gate can rely on. ## Core Features & Use Cases - Code-blind holdout evaluation: Exercises born-verifiable done-criteria (scenarios and assertions) against a provisioned running environment, never reading the diff, codebase, or the builder's test suite. - Mechanical classification and fail-closed judging: Uses faff dod classify to partition criteria, forces prose criteria to needs-human, delegates integration-tier criteria to the review/merge test floor, and emits a validated faff-contract:holdout-verdict block. - Spawner-attested blindness: Under the caged form, evaluate-call.mjs provably withholds the repo from the evaluator process, derives code_blind itself, stamps the attestation, and scrubs credentials before persisting the verdict. - Use Case: In an L4 unattended delivery run, after a build completes, this evaluator provisions an environment, exercises each spec criterion against the live endpoints, and writes a verdict that the merge gate consumes to decide whether the change may land. ## Quick Start Configure the evaluator slot to faffter-noon-evaluate and run a holdout evaluation of the current spec against a provisioned environment to produce a holdout-verdict block.

Frequently Asked Questions about faffter-noon-evaluate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify a feature meets its spec without reading the code?▼

Run a holdout evaluation that exercises the spec's born-verifiable done-criteria against the running feature's endpoints. The evaluator classifies each criterion as scenario, assertion, or prose, judges only the first two against live responses, and emits a holdout-verdict contract block.

What is a code-blind holdout evaluation in CI?▼

It is an evaluation where the judge receives only the spec and a running environment, never the diff, codebase, or build history. Blindness is attested by an external spawner that provably withholds the repository from the evaluator process, so the verdict cannot be influenced by the implementation.

How are prose acceptance criteria handled in automated spec evaluation?▼

Prose criteria are never machine-judged; they are mechanically forced to a needs-human verdict with no evidence flag. The holdout-verdict contract rejects any prose criterion judged otherwise, so ambiguous requirements always route back to a person.

What happens when the evaluation environment fails to become ready?▼

A non-ready environment is never judged as a failure of the feature. The evaluator emits an aggregate of needs-human with empty criteria and a violations note, then tears the environment down, since an unexercised feature was not proven to fail.

Can the evaluator read the project's own test suite to decide a verdict?▼

No. Reading the builder's tests is an explicit anti-pattern because it re-imports the code's blind spots and breaks the code-blind lane invariant. Integration-tier criteria that require those tests are delegated to the review/merge test floor instead.

How are credentials handled when exercising authenticated endpoints?▼

When the environment handle carries credentials, derived auth headers such as Authorization Bearer tokens are attached to every request. Tokens are never written to evidence, verdicts, or logs, and the spawner scrubs any leaked secret from persisted output.