@tcanaud/qa-system

Governance-native QA verification for the kai governance stack. Generates executable test scripts from specifications and agreements, produces PASS/FAIL verdicts, and feeds non-blocking findings into the product pipeline.

Installation

Via tcsetup (recommended)

npx @tcanaud/tcsetup init

Standalone

npx @tcanaud/qa-system init

This creates:

• .qa/ root directory
• .claude/commands/qa.plan.md
• .claude/commands/qa.run.md
• .claude/commands/qa.check.md

Updating

npx @tcanaud/qa-system update

Updates slash command templates without touching .qa/ contents.

Commands

Command	Purpose
/qa.plan {feature}	Generate test scripts from spec.md + agreement.yaml
/qa.run {feature}	Execute scripts and produce PASS/FAIL verdict
/qa.check	Check test plan freshness across all features

How It Works

1. /qa.plan reads .knowledge/ to understand your project, extracts acceptance criteria from spec.md, and generates executable test scripts in .qa/{feature}/scripts/
2. /qa.run checks freshness (SHA-256 checksums), executes all scripts, and produces a binary verdict. Non-blocking findings go to .product/inbox/
3. /qa.check scans all features and reports which test plans are current vs stale

Zero Dependencies

This package uses only Node.js built-in modules (node: protocol imports). No third-party runtime dependencies.

License

MIT