docs: add showcase example for tool and validation management #4565

New issue

Closed

opened 2026-04-08 15:20:12 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-08 15:20:12 +00:00

Owner

Summary

Add a CLI showcase guide that walks through the complete lifecycle for managing tools and validations (register, list, inspect, update, remove)
Ensure the example reflects the canonical agents entrypoint, capability flags, and validation modes documented in the specification
Extend the showcase index so the new example is discoverable alongside the existing CLI workflows

Motivation

Specification §Tool Registry and §Validation Mode require a discoverable reference that demonstrates how tools and validations share the unified registry, how capability flags affect execution, and how wrapped validations reuse existing tooling. QA reviewers flagged the missing showcase as a documentation gap during the March doc audit.

Acceptance Criteria

docs/showcase/cli-tools/tool-and-validation-management.md documents the end-to-end lifecycle with real verified command output
The guide explains capability flags, resource slots, validation modes, and JSON output for scripting
docs/showcase/examples.json lists the new example with title, feature area, command list, and metadata
Linked PR references this issue with a closing keyword

## Summary - Add a CLI showcase guide that walks through the complete lifecycle for managing tools and validations (register, list, inspect, update, remove) - Ensure the example reflects the canonical `agents` entrypoint, capability flags, and validation modes documented in the specification - Extend the showcase index so the new example is discoverable alongside the existing CLI workflows ## Motivation Specification §Tool Registry and §Validation Mode require a discoverable reference that demonstrates how tools and validations share the unified registry, how capability flags affect execution, and how wrapped validations reuse existing tooling. QA reviewers flagged the missing showcase as a documentation gap during the March doc audit. ## Acceptance Criteria - [ ] `docs/showcase/cli-tools/tool-and-validation-management.md` documents the end-to-end lifecycle with real verified command output - [ ] The guide explains capability flags, resource slots, validation modes, and JSON output for scripting - [ ] `docs/showcase/examples.json` lists the new example with title, feature area, command list, and metadata - [ ] Linked PR references this issue with a closing keyword

HAL9000 added this to the v3.4.0 milestone

2026-04-08 15:31:11 +00:00

~~HAL9000 referenced this issue 2026-04-08 15:33:46 +00:00~~

docs: add showcase example for tool and validation management #4212

HAL9000 referenced this issue

2026-04-08 15:39:35 +00:00

docs: add showcase example for tool and validation management #4212

HAL9000 commented

2026-04-08 15:49:02 +00:00

Author

Owner

MoSCoW classification: Could Have

Rationale: This is a showcase documentation guide for tool and validation management. While the specification references these features, the showcase documentation is supplementary — the core tool registry and validation functionality is what matters for v3.4.0 milestone completion. Showcase docs improve discoverability and user experience but are not required for the acceptance criteria. Could Have.

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner

MoSCoW classification: **Could Have** Rationale: This is a showcase documentation guide for tool and validation management. While the specification references these features, the showcase documentation is supplementary — the core tool registry and validation functionality is what matters for v3.4.0 milestone completion. Showcase docs improve discoverability and user experience but are not required for the acceptance criteria. Could Have. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

Rows
Columns