kata-push-to-framework

What problem does it solve?

It streamlines the repetitive work of taking newly written project documentation artifacts and promoting them into a shared framework structure, including ensuring required i18n language variants exist.

Core Features & Use Cases

• Artifact promotion with structure validation: Scans .md files under a configured project artifacts root, validates expected lang/clade/subclade/pilar layout, and prepares exact destination paths in the framework.
• Automated i18n completion: Copies missing language files by invoking translation from the default-language artifact, ensuring all required languages are present at the destination.
• Local or remote publishing workflow: Supports local filesystem copying and GitHub-MCP-only remote synchronization that creates a branch, commits, and opens a PR in the framework repository.
• Optional cleanup: Can remove promoted artifacts from the project after a successful local copy or remote PR creation.

Quick Start

Ask the AI to run kata-push-to-framework in local mode and promote all markdown artifacts found under the configured artifacts directory into the framework, generating any missing i18n translations for the required languages.