skills/proffesor-for-testing__agentic-qe

mirror of https://github.com/proffesor-for-testing/agentic-qe.git synced 2026-09-19 08:45:47 +08:00

Files

T

Profa 2253d05618 feat: flatten project structure — archive v2, promote v3 to root

Remove the nested v3/ subdirectory by moving all active source code,
tests, configs, and assets directly to the project root. Archive v2/
(dead code, 847MB) to v2-archive.tar.gz.

Key changes:
- Move v3/src/ → src/, v3/tests/ → tests/, v3/packages/ → packages/
- Move v3/tsconfig.json, v3/vitest.config.ts to root
- Merge v3/package.json into root package.json (ESM, scripts, deps, exports)
- Merge v3/scripts/ into scripts/, v3/implementation/ into docs/implementation/
- Update all CI workflows to remove "cd v3 &&" and v3/ path prefixes
- Fix all init installer path resolution (3-level-up → 2-level-up)
- Fix hooks to use "node ./dist/cli/bundle.js" instead of bare "aqe"
- Update settings.json ADR/DDD directories to docs/implementation/
- Fix helper scripts (statusline, adr-compliance, ddd-tracker, guidance-hooks)
- Update 58 agent definitions: aqe/v3/ → aqe/ memory namespaces
- Update 15 guidance shards: v3/src/ → src/ path references
- Fix sync interfaces: remove v3/ and v2/ path references
- Fix test path calculations (process.cwd() + '..' no longer needed)
- Fix flaky perf test threshold (500ms → 1000ms for CI environments)
- Fix complexity-analyzer test to match ADR-051 keyword-based eligibility

Build passes, 17,901 tests pass, CLI and MCP bundles verified.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-01 11:35:41 +00:00

5.4 KiB

Raw Permalink Blame History

SPEC-045-C: V2 Compatibility Aliases

Field	Value
Specification ID	SPEC-045-C
Parent ADR	ADR-045
Version	1.0
Status	Implemented
Last Updated	2026-01-14
Author	Migration Analysis Agent

Overview

This specification documents the V2 agent name aliases for backward compatibility. V2 agents that have equivalent V3 agents are mapped to their new version-agnostic names.

V2 to New Name Mapping

Direct Aliases

These V2 agent names map directly to their V3 equivalents:

v2-aliases:
  qe-test-generator: qe-test-architect
  qe-coverage-analyzer: qe-coverage-specialist
  qe-flaky-test-hunter: qe-flaky-hunter
  qe-test-executor: qe-parallel-executor
  qe-deployment-readiness: qe-deployment-advisor
  qe-api-contract-validator: qe-contract-validator
  qe-regression-risk-analyzer: qe-regression-analyzer
  qe-a11y-ally: qe-accessibility-auditor

Conflicting Names (V3 Inherits)

These names existed in both V2 and V3. V3 agents now use the canonical name:

Agent Name	V2 Agent	V3 Agent	Resolution
`qe-quality-gate`	V2 implementation	V3 implementation	V3 inherits name
`qe-security-scanner`	V2 implementation	V3 implementation	V3 inherits name
`qe-chaos-engineer`	V2 implementation	V3 implementation	V3 inherits name
`qe-visual-tester`	V2 implementation	V3 implementation	V3 inherits name
`qe-code-intelligence`	V2 implementation	V3 implementation	V3 inherits name
`qe-requirements-validator`	V2 implementation	V3 implementation	V3 inherits name
`qe-code-complexity`	V2 implementation	V3 implementation	V3 inherits name
`qe-performance-tester`	V2 implementation	V3 implementation	V3 inherits name
`qe-fleet-commander`	V2 implementation	V3 implementation	V3 inherits name

V2-Only Agents (Kept Separate)

These V2 agents have no direct V3 equivalent and retain their original names:

Agent Name	Description	Status
`qe-quality-analyzer`	Quality metrics analysis	Kept as separate agent
`qe-production-intelligence`	Production data analysis	Kept as separate agent
`qe-test-data-architect`	Test data generation	New agent needed in V3

V2 Skills Added to V3

The following V2 QE skills were added to V3 with their original (version-agnostic) names:

Skill Name	Description
`accessibility-testing`	WCAG accessibility testing
`tdd-london-chicago`	TDD methodology skills
`api-testing-patterns`	API testing patterns
`contract-testing`	Consumer-driven contracts
`chaos-engineering-resilience`	Chaos engineering
`performance-testing`	Load and stress testing
`security-testing`	Security vulnerability testing
`exploratory-testing-advanced`	Session-based testing
`mutation-testing`	Test quality validation
`regression-testing`	Regression test selection

Total V2 skills added: 36 QE-related skills

Alias Resolution Logic

// Agent alias resolution
function resolveAgentAlias(name: string): string {
  const aliases: Record<string, string> = {
    'qe-test-generator': 'qe-test-architect',
    'qe-coverage-analyzer': 'qe-coverage-specialist',
    'qe-flaky-test-hunter': 'qe-flaky-hunter',
    'qe-test-executor': 'qe-parallel-executor',
    'qe-deployment-readiness': 'qe-deployment-advisor',
    'qe-api-contract-validator': 'qe-contract-validator',
    'qe-regression-risk-analyzer': 'qe-regression-analyzer',
    'qe-a11y-ally': 'qe-accessibility-auditor',
  };

  return aliases[name] || name;
}

Naming Convention Comparison

Aspect	V2 Pattern	V3 Pattern
Prefix	`qe-`	`qe-`
Version indicator	None	None (removed v3-)
Domain hint	Implicit	Explicit where helpful
Function	Varied (`-generator`, `-analyzer`)	Standardized (`-specialist`, `-architect`)

Examples

V2 Name	V3 Name	Notes
`qe-test-generator`	`qe-test-architect`	Elevated role terminology
`qe-coverage-analyzer`	`qe-coverage-specialist`	Consistent -specialist suffix
`qe-flaky-test-hunter`	`qe-flaky-hunter`	Simplified

Implementation Notes

What Was Implemented

V2 skill files copied to V3 assets (36 skills)
Alias resolution available in agent registry
V2 agents with conflicting names superseded by V3

What Was Not Implemented (Per User Decision)

Deprecation warnings when using V2 names
Automatic V2-to-V3 name translation at runtime
Backward compatibility symlinks for CLI

Spec ID	Title	Relationship
SPEC-045-A	Agent Mapping	V3 agent names
SPEC-045-B	Migration Strategy	Implementation details

Changelog

Version	Date	Author	Changes
1.0	2026-01-14	Migration Agent	Initial specification
1.0	2026-01-20	Architecture Team	Extracted from ADR-045

5.4 KiB Raw Permalink Blame History