Create Commands
The create category contains commands for AI-powered content generation and documentation creation.
Commands in this Category
| Command | Purpose |
|---|---|
| create pr | Create pull request with AI-generated description |
| create spec | Generate Gherkin specifications from natural language |
| create design | Generate workspace.dsl for a module using AI |
| create risk-profile | Create OSCAL profile from risk assessment |
| create risk-assess | Update OSCAL assessment-results with evidence |
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.
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.