# ROSA Docs And Structure Tests

> Keep CLI docs, structure tests, and user-facing guidance in sync when commands or workflow docs change.

- Skill: `tuyv/rosa-docs-and-structure-tests` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add tuyv/rosa-docs-and-structure-tests`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tuyv/rosa-docs-and-structure-tests/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tuyv (https://skillmd.com/u/tuyv)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tuyv/rosa-docs-and-structure-tests

---


# ROSA Docs And Structure Tests

Use this skill when:

- Command tree or flag changes are part of the task
- Help text or generated CLI docs changed
- `AGENTS.md`, `CONTRIBUTING.md`, `guidelines/*-guidelines.md`, PR templates, or issue forms are being updated

## Workflow

1. If the command tree changes, update `cmd/rosa/structure_test/command_structure.yml`.
2. If flags change, update the matching `cmd/rosa/structure_test/command_args/**/command_args.yml`.
3. If command help text or generated docs should change, run `make generate-docs`.
4. Keep `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `CONTRIBUTING.md`, `guidelines/ARCHITECTURE.md`, and `.github/pull_request_template.md` aligned when workflow wording changes.
5. Keep issue templates specific to real ROSA workflows and reproducible reports.
6. For AWS-facing docs, cross-check the official ROSA and AWS docs linked from `AGENTS.md`.

## Verification

- Re-read the edited docs for stale commands, placeholders, and drift from the real workflow.
- Confirm command and flag docs match the structure-test files.
- Run any required local verification from `CONTRIBUTING.md`.