rosa-docs-and-structure-tests
Keep CLI docs, structure tests, and user-facing guidance in sync when commands or workflow docs change.
Source facts
- Repository
- TuYv/ccpm
- Last source activity
- June 28, 2026 at 00:16
- Detected SKILL.md language
- English
- Stars
- 1
- Forks
- 2
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
2 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- ROSA Docs And Structure Tests
- description
- Keep CLI docs, structure tests, and user-facing guidance in sync when commands or workflow docs change.
# 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`.
View on GitHub