Pattern Proposal: Declarative Agent Command Registry

Summary

Externalizes agent task specifications and skills into declarative TOML manifests in the repository.

Candidate Pattern

• ID: declarative-agent-command-registry
• Classification: intelligence
• Maturity: established
• Type: implemented

Observed Signals

No specific signals listed.

Evidence

Supporting Evidence

• .agents/commands/speckit.plan.toml - Defines declarative command contract for the planning agentic skill.
• .agents/commands/speckit.analyze.toml - Defines declarative specification for analysis workflows.

Scope Assessment

• Evidence Strength: high
• Confidence: high
• Applies to: ideas-to-life-cas

Rationale

• Intent: Standardize how agent capabilities (planning, specifying, analyzing, migrating) are defined, shared, and triggered.
• Context: Located in .agents/commands/ and .agents/skills/ to configure speckit lifecycle operations.
• Force: Hardcoded CLI commands make agent workflows rigid and difficult to configure per project
• Force: Agents and human developers need identical interfaces to invoke standardized architectural skills

Traceability

Artifact source: proposed-patterns