# cgd-generator

Generate Clarity-Gated Documents (`.cgd`) using LLM assistance — epistemic markers for safe LLM ingestion.

[![PyPI version](https://badge.fury.io/py/cgd-generator.svg)](https://pypi.org/project/cgd-generator/)
[![License: CC BY 4.0](https://img.shields.io/badge/License-CC_BY_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)

## Status: Coming Soon

This package is part of the [Clarity Gate](https://github.com/frmoretto/clarity-gate) ecosystem for epistemic quality verification.

**Functionality is under development.**

## What Will This Do?

`cgd-generator` will use LLM assistance to generate properly annotated Clarity-Gated Documents with:
- Automatic epistemic marker insertion
- HITL verification routing
- Exclusion block suggestions
- Format compliance guaranteed

## Related Packages

- [cgd-creator](https://pypi.org/project/cgd-creator/) - Create .cgd files manually
- [cgd-validator](https://pypi.org/project/cgd-validator/) - Validate existing .cgd files
- [sot-generator](https://pypi.org/project/sot-generator/) - Generate .sot files with LLM

## File Format Specification

See [CGD_FORMAT.md](https://github.com/frmoretto/clarity-gate/blob/main/docs/CGD_FORMAT.md) for the complete format specification.

## License

CC BY 4.0 — Use freely with attribution.

## Author

Francesco Marinoni Moretto  
GitHub: [@frmoretto](https://github.com/frmoretto)
