@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