Migration update

qmims has been migrated from Amazon Q CLI to Kiro CLI. These docs reflect the current install, authentication, and command workflows.

Templates Command

Manage built-in and custom README templates

The templates command helps you inspect, add, and remove templates used by qmims. Templates are useful when you want a consistent README structure across projects while still letting Kiro generate the actual content.

Syntax

qmims templates <action> [name] [path]

Actions

ActionDescription
listList all available templates
showShow the content of a specific template
addAdd a custom template from a Markdown file
removeRemove a previously added custom template

Examples

List all available templates:

qmims templates list

Show the content of the built-in basic template:

qmims templates show basic

Add a custom template from a Markdown file:

qmims templates add my-template path/to/template.md

Remove a custom template you no longer need:

qmims templates remove my-template

Use a template after adding it:

qmims generate --mode template:my-template

Built-in Templates

qmims includes several built-in templates for common project types:

TemplateDescription
basicA simple README with essential sections
detailedA more comprehensive README with extended structure
minimalA lightweight README for small or straightforward projects
libraryA template focused on package and API documentation
serviceA template tailored to services, APIs, and deployments

Creating a Custom Template

A custom template is just a Markdown file that provides structure for the generated README. qmims writes the template first, then uses Kiro to analyze the project and fill in the sections.

A simple example template might look like this:

# Project Name

## Overview

Add a concise summary here.

## Installation

Document installation steps here.

## Usage

Add examples and common workflows here.

## License

Describe the project's license here.

Save that file, then add it to qmims with the add action:

qmims templates add internal-standard docs/templates/internal.md

Recommended Template Workflow

  1. Create or choose a template
  2. Add it with the templates command if it is custom
  3. Generate a README with qmims generate --mode template:template-name
  4. Review the generated content and make any final refinements

Related Docs