docs: left-justify prerequisite tables

Author: david-waltermire

README.md

@@ -117,6 +117,37 @@ To disable colored output, use the `--no-color` flag:
 metaschema-cli --no-color <command>
 ```
 
+#### Shell Completion
+
+The CLI supports tab completion for Bash and Zsh shells, providing intelligent suggestions for commands, subcommands, and options.
+
+**Bash:**
+
+```bash
+# Generate and source completion (temporary, current session only)
+source <(metaschema-cli shell-completion bash)
+
+# Or save to a file and source it in your ~/.bashrc for persistence
+metaschema-cli shell-completion bash --to ~/.metaschema-completion.bash
+echo 'source ~/.metaschema-completion.bash' >> ~/.bashrc
+```
+
+**Zsh:**
+
+```zsh
+# Ensure your completions directory exists
+mkdir -p ~/.zsh/completions
+
+# Generate completion script
+metaschema-cli shell-completion zsh > ~/.zsh/completions/_metaschema-cli
+
+# Add to your ~/.zshrc if not already configured
+echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
+echo 'autoload -Uz compinit && compinit' >> ~/.zshrc
+```
+
+After setting up completion, restart your shell or source the configuration file.
+
 ## Relationship to prior work
 
 The contents of this repository is based on work from the [Metaschema Java repository](https://github.com/usnistgov/metaschema-java/) maintained by the National Institute of Standards and Technology (NIST), the [contents of which have been dedicated in the worldwide public domain](https://github.com/usnistgov/metaschema-java/blob/1a496e4bcf905add6b00a77a762ed3cc31bf77e6/LICENSE.md) using the [CC0 1.0 Universal](https://creativecommons.org/publicdomain/zero/1.0/) public domain dedication. This repository builds on this prior work, maintaining the [CCO license](https://github.com/metaschema-framework/metaschema-java/blob/main/LICENSE.md) on any new works in this repository.

src/site/markdown/building.md.vm

@@ -5,7 +5,7 @@ This guide explains how to build the Metaschema Java project from source code.
 ## Prerequisites
 
 | Requirement | Minimum Version | Notes |
-|-------------|-----------------|-------|
+|:------------|:----------------|:------|
 | Java JDK    | 17              | Required for building (output JARs are JDK 11 compatible) |
 | Maven       | 3.9.0           | Required for building |
 | Git         | 2.0             | Required for cloning |
@@ -146,6 +146,16 @@ export MAVEN_OPTS="-Xmx2g"
 mvn install
 ```
 
+## Building the Site
+
+To build the project documentation site:
+
+```bash
+mvn site
+```
+
+The generated site appears in `target/site/`. For multi-module builds, each module's site is in its respective `target/site/` directory.
+
 ## Contributing
 
 For contribution guidelines, including code style requirements and the pull request process, see [CONTRIBUTING.md](${project.scm.url}/blob/develop/CONTRIBUTING.md).

src/site/markdown/claude-integration.md.vm

@@ -14,7 +14,7 @@ Claude Code plugins provide specialized skills for:
 ## Prerequisites
 
 1. [Install Claude Code](https://docs.anthropic.com/en/docs/claude-code)
-2. Ensure the Metaschema plugins are available in your configuration
+2. Install the [Metaschema plugins](https://github.com/metaschema-framework/claude-plugins/tree/main)
 
 ## Available Plugins
 
@@ -23,7 +23,7 @@ Claude Code plugins provide specialized skills for:
 Skills for working with Metaschema definitions:
 
 | Skill | Description |
-|-------|-------------|
+|:------|:------------|
 | `metaschema:metaschema-basics` | Introduction to Metaschema concepts |
 | `metaschema:metaschema-module-authoring` | Creating and modifying modules |
 | `metaschema:metaschema-constraints-authoring` | Defining validation constraints |
@@ -34,15 +34,15 @@ Skills for working with Metaschema definitions:
 Skills for working with OSCAL documents:
 
 | Skill | Description |
-|-------|-------------|
+|:------|:------------|
 | `oscal:oscal-basics` | OSCAL document types and structure |
 
 ### Tool Plugins
 
 Skills for using CLI and library tools:
 
 | Skill | Description |
-|-------|-------------|
+|:------|:------------|
 | `oscal-tools:using-oscal-cli` | Running oscal-cli commands |
 | `metaschema-tools:using-metaschema-java` | Using the Metaschema Java library |
 
@@ -51,7 +51,7 @@ Skills for using CLI and library tools:
 For contributors to the Metaschema framework:
 
 | Skill | Description |
-|-------|-------------|
+|:------|:------------|
 | `dev-metaschema:development-workflow` | TDD, debugging, testing patterns |
 | `dev-metaschema:repo-organization` | Project structure and relationships |
 | `dev-metaschema:unit-test-writing` | Writing comprehensive tests |
@@ -105,6 +105,8 @@ When working with the Metaschema Java library, Claude can help you:
 
 ## Learn More
 
+For more information about Claude Code and the technologies used in this project:
+
 - [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)
 - [Metaschema Specification](https://pages.nist.gov/metaschema/specification/)
 - [Metapath Reference](https://pages.nist.gov/metaschema/specification/metapath/)