Skip to content

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

  1. AI Generation: AI generates content following the specified output format
  2. Validation: Output is validated against format-specific rules (syntax, schema, standards)
  3. Automatic Retry: If validation fails, AI receives error feedback and regenerates improved output
  4. 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:

r2r eac create pr

Specification Generation:

r2r eac create spec "User can login with email and password"

Architecture Documentation:

r2r eac create design src-auth

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.