framework-development

Evolves the QA framework's KATA layers, fixtures, installer, and OpenAPI pipeline through a gated Plan-Code-Verify-Archive workflow.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/ahuaracab/test-genesis --skill framework-development-ahuaracab
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: framework-development
Source: https://github.com/ahuaracab/test-genesis/tree/main/.agents/skills/framework-development
Command: npx skills add https://github.com/ahuaracab/test-genesis --skill framework-development-ahuaracab

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes references (resource) components.

What problem does it solve? Changes to a test framework's core infrastructure β€” KATA base classes, fixture APIs, the CLI installer, or the OpenAPI type-sync pipeline β€” carry high regression risk because every test depends on them. This Skill enforces a planning gate and structured pipeline so architectural changes are reviewed, verified, and archived instead of being improvised. ## Core Features & Use Cases - Gated four-phase pipeline: Plan β†’ Code β†’ Verify β†’ Archive with subagent dispatch, session resume checks, and a mandatory preflight toolchain gate. - Path guardrails: ALLOWED/FORBIDDEN path tables in references/kata-invariants.md prevent framework work from leaking into per-ticket test specs owned by other skills. - Parallel verification: runs test suite, typecheck, lint, and skill-registry checks concurrently before accepting any change. - Use Case: When adding a new fixture API to the Playwright-based KATA framework, the skill plans the change against kata-manifest.json, implements it in batches, verifies with four parallel checks, and archives the session artifacts. ## Quick Start Ask the AI to evolve the framework by describing the infrastructure change, for example: run /framework-development to add a new fixture API to the KATA test framework.

Frequently Asked Questions about framework-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new fixture API to a Playwright KATA test framework?β–Ό

Use the framework-development workflow: it plans the change against kata-manifest.json, updates the matching Fixture file (ApiFixture, UiFixture, or TestFixture), registers the component, and verifies with test, typecheck, and lint runs. Orphan fixtures without a consuming test are rejected.

When should I use framework-development instead of test-automation?β–Ό

Use framework-development only for changes to the framework itself: KATA base classes, fixtures, installer, scripts, and the OpenAPI pipeline. Writing or migrating per-ticket test specs in tests/e2e or tests/integration belongs to the test-automation skill.

Can framework-development modify test specs or generated files?β–Ό

No. Per-ticket specs under tests/e2e and tests/integration, generated artifacts like api/openapi-types.ts and kata-manifest.json, and .context/ QA folders are FORBIDDEN paths. Changes spanning both surfaces are split between framework-development and the owning skill.

What verification runs before a framework change is accepted?β–Ό

Four parallel verifiers run: bun run test, bun run types:check, bun run lint:check, and bun run skills:check. All four must exit zero; any failure rejects the change and the orchestrator offers retry, skip-and-document, or abort without auto-fixing.

What happens if a framework-development session is interrupted?β–Ό

Session state persists in .session/framework-development/<change-name>/ with plan.md and progress.md files. On the next run, Phase 0 detects the prior state and offers resume, restart, or abort, so mid-run crashes do not lose progress.