Expand Agent QC standard to v0.4.0

Author: wutongci

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v0.4.0 - 2026-05-10
+
+- Added Agent UI-inspired best practices, flow taxonomy, evidence contract, and performance/reliability metrics pages.
+- Expanded quickstart, project classification, gate matrix, acceptance scenarios, and verdict guidance with runtime-backed surface evidence rules.
+- Updated source traceability, navigation, README, and LLM entrypoints to include Agent UI, Agent Knowledge, Playwright, Vitest, pytest, and local star-project references.
+- Bumped package and public plan schema version to `0.4.0`.
+
 ## v0.3.0 - 2026-05-10
 
 - Expanded project case studies for Codex, Claude Code snapshot, OpenClaw, Hermes Agent, and Lime.

README.md

@@ -15,11 +15,13 @@ Lime is now only one profile and example. The standard is meant to apply to any
 | Evidence systems | Durable traces, provenance, review, replay, export. | Evidence refs required by QC verdicts. |
 | Humans / LLM judges | Review of semantics, UX, safety, and output quality. | Rubric shape and verdict contract. |
 
-## What v0.3.0 defines
+## What v0.4.0 defines
 
 - A project classification model for Agent products.
 - A cross-project gate matrix from static checks to live provider tests and release smoke.
 - Interaction surface rules for CLI streams, TUI, WebUI, desktop GUI, browser automation, channel UI, and eval UI.
+- Best practices adapted from Agent UI runtime-backed projection and Agent Skills progressive disclosure.
+- Portable evidence and performance/reliability contracts.
 - Core objects: `qc_plan`, `qc_case`, `qc_gate`, `qc_run`, `qc_verdict`, `qc_evidence`, and `qc_report`.
 - Evidence-driven verdict rules for pass, fail, blocked, exhausted, waived, and needs-review.
 - qcloop integration for repeated independent QC cases.
@@ -45,12 +47,17 @@ A real project usually combines several profiles.
 ## Documentation
 
 - [Specification](docs/en/specification.md)
+- [Quickstart](docs/en/authoring/quickstart.md)
+- [Best practices](docs/en/authoring/best-practices.md)
 - [Project classification](docs/en/authoring/project-classification.md)
 - [Gate matrix](docs/en/authoring/gate-matrix.md)
 - [Interaction surface testing](docs/en/authoring/interaction-surface-testing.md)
 - [qcloop integration](docs/en/authoring/qcloop-integration.md)
 - [Evidence-driven verdicts](docs/en/authoring/evidence-driven-verdicts.md)
 - [Acceptance scenarios](docs/en/authoring/acceptance-scenarios.md)
+- [Evidence contract](docs/en/contracts/evidence-contract.md)
+- [Performance and reliability metrics](docs/en/contracts/performance-and-reliability-metrics.md)
+- [Flow and taxonomy](docs/en/reference/flow-and-taxonomy.md)
 - [Case-study patterns](docs/en/reference/agent-project-patterns.md)
 - [Star project testing systems](docs/en/reference/star-project-testing-systems.md)
 - [中文规范](docs/zh/specification.md)

RELEASE_NOTES.md

@@ -1,5 +1,22 @@
 # Release Notes
 
+## v0.4.0
+
+Agent QC v0.4.0 turns the v0.3.0 case-study expansion into a fuller standard surface. It incorporates Agent UI's runtime-backed projection practices, Agent Skills-style progressive disclosure, and concrete evidence patterns from Codex, Claude Code local snapshot, OpenClaw, Hermes Agent, and Lime.
+
+### Highlights
+
+- Adds best-practice guidance for risk-owned classification, fact ownership, qcloop boundaries, and evidence-first reports.
+- Adds a full flow/taxonomy reference covering profiles, surfaces, gates, evidence kinds, verdict statuses, fact owners, case envelopes, and report envelopes.
+- Adds an evidence contract for evidence refs, verdict objects, gate minimums, surface add-ons, waiver rules, and anti-patterns.
+- Adds performance and reliability metrics for runtime responsiveness, stream health, tool/permission reliability, GUI/TUI/WebUI/browser evidence, scheduler recovery, and release smoke.
+- Expands quickstart, gate matrix, project classification, acceptance scenarios, and evidence-driven verdicts so Lime is clearly only one case study.
+- Refreshes LLM entrypoints, navigation, source index, README, and public schema/examples for `0.4.0`.
+
+### Scope
+
+This release is documentation- and schema-version focused. It does not introduce a new framework requirement; it standardizes stronger evidence shapes that any Agent project can map to its own test stack.
+
 ## v0.3.0
 
 Agent QC v0.3.0 deepens the standard with concrete testing systems from major Agent projects. It focuses on how runtime, TUI, GUI, WebUI, gateway, background, and release tests should be shaped and evidenced.

docs/.vitepress/config.ts

@@ -1,7 +1,7 @@
 import { defineConfig } from 'vitepress'
 
 const base = process.env.VITEPRESS_BASE || '/'
-const versions = ['0.3.0', '0.2.0', '0.1.0']
+const versions = ['0.4.0', '0.3.0', '0.2.0', '0.1.0']
 
 const enVersionItems = versions.flatMap((version) => [
   { text: `v${version} overview`, link: `/en/versions/v${version}/overview` },
@@ -18,6 +18,7 @@ const zhVersionItems = versions.flatMap((version) => [
 const enNav = [
   { text: 'Guide', link: '/en/what-is-agent-qc' },
   { text: 'Specification', link: '/en/specification' },
+  { text: 'Best Practices', link: '/en/authoring/best-practices' },
   { text: 'Examples', link: '/en/examples/codex-runtime-cli' },
   { text: 'Surfaces', link: '/en/authoring/interaction-surface-testing' },
   { text: 'Ecosystem', link: '/en/reference/agent-ecosystem' },
@@ -27,6 +28,7 @@ const enNav = [
 const zhNav = [
   { text: '指南', link: '/zh/what-is-agent-qc' },
   { text: '规范', link: '/zh/specification' },
+  { text: '最佳实践', link: '/zh/authoring/best-practices' },
   { text: '示例', link: '/zh/examples/codex-runtime-cli' },
   { text: '交互表面', link: '/zh/authoring/interaction-surface-testing' },
   { text: '生态', link: '/zh/reference/agent-ecosystem' },
@@ -41,16 +43,22 @@ const enSidebar = [
   ] },
   { text: 'For QC authors', items: [
     { text: 'Quickstart', link: '/en/authoring/quickstart' },
+    { text: 'Best practices', link: '/en/authoring/best-practices' },
     { text: 'Project classification', link: '/en/authoring/project-classification' },
     { text: 'Gate matrix', link: '/en/authoring/gate-matrix' },
     { text: 'Interaction surface testing', link: '/en/authoring/interaction-surface-testing' },
     { text: 'qcloop integration', link: '/en/authoring/qcloop-integration' },
     { text: 'Evidence-driven verdicts', link: '/en/authoring/evidence-driven-verdicts' },
     { text: 'Acceptance scenarios', link: '/en/authoring/acceptance-scenarios' }
   ] },
+  { text: 'Contracts', items: [
+    { text: 'Evidence contract', link: '/en/contracts/evidence-contract' },
+    { text: 'Performance and reliability metrics', link: '/en/contracts/performance-and-reliability-metrics' }
+  ] },
   { text: 'Reference', items: [
     { text: 'Glossary', link: '/en/reference/glossary' },
     { text: 'Agent project patterns', link: '/en/reference/agent-project-patterns' },
+    { text: 'Flow and taxonomy', link: '/en/reference/flow-and-taxonomy' },
     { text: 'Star project testing systems', link: '/en/reference/star-project-testing-systems' },
     { text: 'Source index', link: '/en/reference/source-index' },
     { text: 'Agent standards ecosystem', link: '/en/reference/agent-ecosystem' }
@@ -74,16 +82,22 @@ const zhSidebar = [
   ] },
   { text: 'QC 作者', items: [
     { text: '快速开始', link: '/zh/authoring/quickstart' },
+    { text: '最佳实践', link: '/zh/authoring/best-practices' },
     { text: '项目分类', link: '/zh/authoring/project-classification' },
     { text: '门禁矩阵', link: '/zh/authoring/gate-matrix' },
     { text: '交互表面测试', link: '/zh/authoring/interaction-surface-testing' },
     { text: 'qcloop 集成', link: '/zh/authoring/qcloop-integration' },
     { text: '证据驱动判定', link: '/zh/authoring/evidence-driven-verdicts' },
     { text: '验收场景', link: '/zh/authoring/acceptance-scenarios' }
   ] },
+  { text: '契约', items: [
+    { text: '证据契约', link: '/zh/contracts/evidence-contract' },
+    { text: '性能与可靠性指标', link: '/zh/contracts/performance-and-reliability-metrics' }
+  ] },
   { text: '参考', items: [
     { text: '术语表', link: '/zh/reference/glossary' },
     { text: 'Agent 项目测试模式', link: '/zh/reference/agent-project-patterns' },
+    { text: '流程与分类', link: '/zh/reference/flow-and-taxonomy' },
     { text: '明星项目测试体系', link: '/zh/reference/star-project-testing-systems' },
     { text: '来源索引', link: '/zh/reference/source-index' },
     { text: 'Agent 标准生态', link: '/zh/reference/agent-ecosystem' }