kpkn-auge-engine

Migrate KPKN AUGE engine behavior from PWA to Kotlin with parity checks.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/rotnitxe/KPKNFit --skill kpkn-auge-engine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kpkn-auge-engine
Source: https://github.com/rotnitxe/KPKNFit/tree/main/kpkn-auge-engine
Command: npx skills add https://github.com/rotnitxe/KPKNFit --skill kpkn-auge-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, argparse, re, pathlib, and includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill prevents behavior drift when migrating the KPKN AUGE engine by treating the PWA as the behavior oracle and the Kotlin implementation as the final target that must preserve numeric invariants.

Core Features & Use Cases

  • Repo-specific AUGE migration guidance: direct you to the exact PWA facade and the corresponding Kotlin landing zones for fatigue, recovery/readiness, batteries, and related training-volume impacts.
  • Parity-first workflow: helps you classify work (parity audit, logic port, gap fill, behavior fix, UI consumer fix) and follow a smallest-slice editing strategy backed by invariants.
  • Validation ladder recommendations: guides you to choose the narrowest useful checks and the appropriate Kotlin build/test commands, plus PWA/Kotlin comparison scripts.
  • Guardrails against common failure modes: flags known risks like Kotlin recomputation with exerciseDb = emptyMap() and worker-wrapper mismatches, so outputs remain behaviorally correct.

Quick Start

Use the kpkn-auge-engine skill to migrate an AUGE behavior bugfix from the PWA into the android-native Kotlin domain layer while preserving invariants and producing parity-oriented validation steps.

Frequently Asked Questions about kpkn-auge-engine

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

FAQPage Schema
How do I migrate PWA engine logic to Kotlin without behavior drift?

To migrate PWA engine logic to Kotlin without behavior drift, treat the PWA facade as the behavior oracle and apply smallest parity-preserving edits to the Kotlin target. Validate outputs using targeted engine checks and surface drift scripts to ensure numeric invariants remain intact.

What is parity validation when porting fatigue and recovery logic?

Parity validation when porting fatigue and recovery logic involves running targeted engine and integration checks alongside PWA/Kotlin comparison scripts. This verifies that the Kotlin domain layer accurately preserves the AUGE numeric invariants and behavior of the original PWA implementation.

How do I fix recovery readiness synthesis bugs in an Android-native Kotlin target?

To fix recovery readiness synthesis bugs in an Android-native Kotlin target, start from the PWA facade surface, map the correct Kotlin landing zones, and apply smallest-slice parity-preserving edits. Use the validation ladder to run narrow checks and verify behavioral correctness.

Why does Kotlin recomputation cause empty map errors during AUGE migration?

Kotlin recomputation causes empty map errors during AUGE migration when worker-wrappers mismatch or logic recomputes with exerciseDb = emptyMap(). This known failure mode produces incorrect training-volume interactions and breaks behavioral parity if not flagged and guarded against.

Do I need Python3 to run PWA and Kotlin surface drift comparison scripts?

Yes, you need Python3 to run PWA and Kotlin surface drift comparison scripts, as the validation tooling relies on Python3 dependencies including argparse, re, and pathlib. These scripts execute the targeted parity checks required during the migration process.