aegis-dept-12-sqa-testing
Coding standards, operational procedures, and engineering rules for AEGIS Department 12: Defensive Coding, SQA & Automated End-to-End Testing
SKILL.md.agents/skills/aegis-dept-12-sqa-testing/SKILL.md
GitHubDepartment 12: Defensive Coding, SQA & Automated End-to-End Testing
Framework: White Caves Engineering Matrix V2 (1-12-108 Software Core)
Protocol: Bhakti 1-12-108
Director:@Rachel_QA— Principal Software Quality Assurance Architect
Tech Stack: Vitest, Playwright, TypeScript, Testing Library, MSW (Mock Service Worker)
9-Node Engineering Roster
| # | Agent | Role | Responsibility |
|---|---|---|---|
| 1 | @Rachel_QA (Director) |
Principal Software Quality Assurance Architect | Owns overall validation check criteria, system test strategies, and quality gates. |
| 2 | @Corinne_QA |
Calculation Engine Unit Test Specialist | Writes strict unit assertions to validate multi-tiered calculation formulas. |
| 3 | @Olivia_QA |
Automated Playwright End-to-End Specialist | Maintains complete automated user journey replication scripts across transaction views. |
| 4 | @Nina_QA |
Pre-Merge Staging Smoke Test Developer | Configures automated pre-commit gates to block regressions from active git branches. |
| 5 | @Nadia_QA |
API Shape Contract Contract Assessor | Confirms live backend endpoint response structures comply with TypeScript type maps. |
| 6 | @Katie_Bouman |
Data Integrity Visual Imaging Specialist | Deploys visual screenshot layout comparison checks to auto-flag rendering drifts. |
| 7 | @Margaret_Hamilton |
Asynchronous Thread Crash Profiler | Performs deep asynchronous execution tests to defend systems from race conditions. |
| 8 | @Annette_Wagner |
Interactive Component Testing Auditor | Validates responsive visual components across extreme scaling view variables. |
| 9 | @Rebecca_Heineman |
High-Stress Logic Breakage Specialist | Runs automated brute-force fuzz injection checking pipelines across input routes. |
Key Codebase Files & Directories
src/**/*.test.tssrc/**/*.test.tsxe2e/vitest.config.tsplaywright.config.ts
Mandatory Coding Rules
- Test coverage: minimum 80% on all business-critical paths
- Unit tests: use Vitest + Testing Library for component/util tests
- E2E tests: use Playwright for critical user journeys (auth, property search, CRM flows)
- API contract tests: validate response shapes against TypeScript interfaces
- Mock external APIs: use MSW (Mock Service Worker) — never hit real endpoints in tests
- Visual regression: screenshot comparison for critical UI components
- Pre-merge gate: all tests must pass before PR merge is allowed
- Fuzz testing: run input fuzzing on form fields and search endpoints quarterly
- Test data: use deterministic fixtures — never Math.random() in test setup
Standard Operating Procedures
Full Test Suite
npx vitest run
E2E Tests
npx playwright test
Coverage Report
npx vitest run --coverage
Auth Flow Tests
npx vitest run src/pages/auth/
Component Tests
npx vitest run src/components/
Aegis V4.1 Governance (All Departments)
- Single Purpose File Law: Every source file must have a single responsibility and remain under 350 lines.
- Canonical 5-Way File Standard: View (
.view.tsx), Logic (.logic.ts), Styles (.styles.ts), Data (.data.ts), Config (.config.ts). - TypeScript Strict: Zero warnings, zero
anybypasses, zero@ts-ignorecomments. - Continuous Deduplication: Zero duplicate handlers, zero ghost directories, zero redundant imports.
- Zero-Backlog Law: All PRs and issues must be resolved before moving to the next sprint.
- Token Preservation Shield: Hard 15,000 token ceiling per task — no runaway retry loops.
- Conventional Commits: All commits must follow
feat|fix|chore|refactor|test|docs(scope): messageformat.