Create Commands
Overview
The create category contains 7 commands for AI-powered content generation and documentation creation.
How AI Generation Works
All create commands use structured AI generation with format-specific validation:
Supported Output Formats
Each command generates content in a specific structured format:
| Command | Output Format | Validation |
|---|---|---|
commit-message |
Plaintext (conventional commits) | Format validation and retry |
spec |
Gherkin (.feature files) | Syntax, step definitions, and quality standards |
design |
Structurizr DSL (workspace.dsl) | DSL syntax validation via Structurizr CLI |
pr |
Markdown (GitHub PR format) | Format validation and retry |
risk-profile |
OSCAL Profile JSON | JSON schema validation |
risk-assess |
OSCAL Assessment Results JSON | JSON schema validation |
squash-message |
Plaintext (commit messages) | Format validation and retry |
Generation Process
- AI Generation: AI generates content following the specified output format
- Validation: Output is validated against format-specific rules (syntax, schema, standards)
- Automatic Retry: If validation fails, AI receives error feedback and regenerates improved output
- Quality Assurance: Validated output is ready to use without manual syntax corrections
This architecture ensures all generated content is syntactically correct and follows best practices.
Commands
| Command | Description |
|---|---|
| create commit-message | Generate AI-powered commit messages from staged changes |
| create design | Generate workspace.dsl for a module using AI |
| create pr | Create pull request with AI-generated description |
| create risk-assess | Create OSCAL assessment-results from existing test and security evidence |
| create risk-profile | Create OSCAL profile from risk assessment using AI |
| create spec | Generate Gherkin specifications from natural language descriptions |
| create squash-message | Generate squash commit message from branch commits |
Common Use Cases
Pull Request Creation:
Specification Generation:
Architecture Documentation:
Key Features
- AI-powered content generation using configured providers
- Integration with Git workflows
- BDD specification support
- OSCAL compliance documentation
- Architecture diagram generation
See Also
Tutorials | How-to Guides | Explanation | Reference
You are here: Reference — information-oriented technical descriptions of the system.