add-new-command

Guide adding new CLI commands to the Torrust Deployer across presentation, application, and testing phases.

4|2|Updated Sep 1, 2025
One-click install
npx skills add https://github.com/torrust/torrust-tracker-deployer --skill add-new-command
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-new-command
Source: https://github.com/torrust/torrust-tracker-deployer/tree/main/.github/skills/add-new-command
Command: npx skills add https://github.com/torrust/torrust-tracker-deployer --skill add-new-command

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides developers to implement new CLI commands for the Torrust Tracker Deployer, ensuring consistent interfaces and robust scaffolding.

Core Features & Use Cases

  • Provides a structured, outside-in approach to adding new commands such as validate, render, or backup, including presentation layer scaffolding, application handler contracts, and domain considerations.
  • Includes guidance on testing, E2E planning, and documentation to accelerate safe, repeatable deployments.
  • Enables quick-start templates and recommended commit messaging to standardize contributions.

Quick Start

Start by creating a new CLI command following this guide's scaffolding and conventions.

Frequently Asked Questions about add-new-command

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new CLI command to the deployer?

Add a new CLI command by following an outside-in approach that scaffolds the presentation layer, defines application handler contracts, and outlines domain considerations for the Torrust Deployer. This structured process ensures scalable and safe command development across presentation, application, and testing phases.

What is the outside-in approach for CLI command development?

The outside-in approach for CLI command development starts with presentation layer scaffolding, then defines application handler contracts, and finally addresses domain considerations. It enforces evaluation of dependencies, components, and safety considerations to ensure consistent interfaces and robust command scaffolding.

How do I structure testing and E2E planning for a new deployer command?

Structure testing for a new deployer command by following the guided process that includes E2E planning and testing phase definitions. This ensures your new commands like validate, render, or backup are safely validated through repeatable deployments before integration.

Do I need to update documentation when adding a new command to the Torrust Deployer?

Yes, you need to update documentation when adding a new command to the Torrust Deployer. The command development process explicitly includes documentation guidance to accelerate safe, repeatable deployments and standardize your contributions with recommended commit messaging.

Can I use quick-start templates to scaffold deployer commands?

Yes, you can use quick-start templates to scaffold deployer commands. The guide provides templates and recommended commit messaging to standardize contributions, ensuring consistent interfaces and robust scaffolding for new commands like validate, render, or backup.

What safety considerations are enforced when developing CLI commands?

Safety considerations when developing CLI commands include evaluating dependencies, components, and potential risks before implementation. The guide enforces this evaluation while outlining documentation and workflows to guarantee safe, repeatable deployments for the Torrust Deployer.