gospelo-kata — KATA Markdown™ for Human-AI Collaboration

A document format and toolkit designed for human-AI collaboration. KATA Markdown™ embeds schema, data, and template in a single file — readable and actionable by both humans and AI without special instructions.

Why gospelo-kata?

When generating documents with AI, you often face problems: no structure, no round-trip, no validation, and AI needs coaching every time. gospelo-kata solves this with a single .kata.md file that contains schema definition, structured data, and a Jinja2-compatible template.

LiveMorph — Bidirectional Real-time Sync

Bidirectional sync between Data blocks and HTML body. Switch modes with one click from VS Code, with the current sync mode always visible in the status bar.

Human-AI Readable — Self-Describing Format

Embedded **Schema** and **Prompt** blocks let AI understand the template without external instructions. Humans read and edit the same file naturally. The build command means AI only needs to generate YAML data.

Secure Packaging — KATA ARchive™ (.katar)

Bundle template, schema, and prompt into a ZIP archive. SHA-256 integrity verification, file-type sandboxing, and AI prompt trust management included.

Installation

pip install gospelo-kata

# With Excel support
pip install gospelo-kata[excel]

Requires Python 3.11+.

Quick Start

# List available templates
gospelo-kata templates

# Generate .kata.md with built-in sample data
gospelo-kata build todo -o ./

# Edit the Data block → update body
gospelo-kata sync to-html todo.kata.md

# Validate
gospelo-kata lint todo.kata.md

Built-in Templates

CLI Commands

See the CLI Reference for details.

VSCode Extension

Install from VS Marketplace:

• Real-time lint (Problems panel)
• LiveMorph sync (context menu / status bar)
• Hover info for data-kata attributes
• Preview CSS for kata styles

Documentation

• Quick Start
• CLI Reference
• KATA Markdown™ Format
• LiveMorph Guide
• Templates
• KATA ARchive Package
• VSCode Extension
• Lint Rules

License

MIT — free for commercial use. Documents and templates you create are yours. See LICENSE.md for details.