Runnable public artifacts from AI product experiments by Guillaume Vele.
This repository is the product-judgment and case-study companion to agent-proof-kit. It focuses on framing AI product behavior as testable workflow quality: public-safe fixtures, short evaluation harnesses and case studies. The canonical release-gate and secret-scan mechanics live in agent-proof-kit; this repo shows how those checks fit real product decisions rather than re-implementing them.
- I work on AI products for constrained domains: sensitive consumer UX, document workflows, and local voice automation.
- I care about evaluation, refusal states and uncertainty, not only impressive model output.
- I can turn vague product risk into testable checks, synthetic examples and clear release decisions.
- The public artifacts use synthetic fixtures so the method is inspectable without exposing private product code or data.
For a fast review, start with the public proof pack. For a concrete generated artifact, read the synthetic decision brief. For repository hygiene, read the public readiness scorecard. For a focused agent-run release gate, see Agent Proof Kit.
- Product framing: turn a broad model capability into a narrow user workflow.
- UX and interaction: make uncertainty, retries and edge cases feel usable.
- Evaluation: define synthetic tests, expected failures and release criteria.
- Implementation: build lightweight prototypes, harnesses and automation loops.
- AI product prototyping for constrained domains.
- Evaluation plans for model-assisted user workflows.
- UX patterns for trust, uncertainty and failure states.
- Local automation and voice agent experiments.
- Privacy-first and evidence-aware product design.
- Sensitive consumer UX evaluation notes
- Local voice automation experiments
- Real estate document workflow evaluation
The src/eval code is intentionally generic. It demonstrates repeatability
checks and action-safety gates for AI-assisted product surfaces.
Run:
npm run verify
npm test
npm run demo
npm run report
npm run report:check
npm run scorecard
npm run scorecard:check
npm run demo:workflow
npm run public:scanExample demo output:
Scenario: stable_capture_quality
Decision: pass
Mean: 82.25
CV: 1.824%
Max delta: 3
Scenario: unstable_capture_quality
Decision: fail
Mean: 65.75
CV: 27.274%
Max delta: 39
See synthetic capture quality evaluation for a filled, public-safe example.
The second demo covers workflow action safety:
Action: summarize_public_notes
Decision: allow
Controls: none
Reason: Read-only action within policy boundary.
Action: generate_unreviewed_legal_conclusion
Decision: block
Controls: human_review
Reason: Unreviewed medical or legal advice is outside the public-safe automation boundary.
See synthetic workflow gate evaluation for the full public-safe example.
The generated decision brief turns the synthetic fixtures into a compact product readout:
- Synthetic decision brief
- Public readiness scorecard
- Generator:
scripts/generate-synthetic-decision-brief.js - Tests:
test/synthetic-decision-brief.test.jsandtest/public-readiness-scorecard.test.js
This repo keeps a minimal local scan for convenience:
npm run public:scanIt checks for token-shaped secrets, personal email exposure and optional blocklist terms. The canonical, more complete release gate lives in agent-proof-kit; this repo defers to it rather than duplicating that logic. A technical scan is not a guarantee against conceptual over-disclosure. See the public proof pack for the local pre-publication workflow.
- A method for framing AI product behavior as testable workflow quality.
- A publication workflow that separates synthetic public evidence from sensitive production material.
- Lightweight harnesses and templates that support product decisions.
This repo does not include:
- Private pre-release product source code.
- Patient images or biometric data.
- Medical diagnostic claims.
- Private prompts or evaluation datasets.
- Client documents or legal files.
- Secrets, API keys or infrastructure details.
The public goal is simple: show product judgment, evaluation discipline and practical prototyping without exposing sensitive work.