/akka:clarify

Identify gaps in the current feature specification.

Usage

/akka:clarify

Description

Analyzes the constitution, feature specification, and conversation history to identify areas that lack sufficient detail. Asks up to 5 highly targeted clarification questions and encodes answers back into the spec.

Typical clarification questions address areas such as:

  • How entities are uniquely identified

  • What happens during deletion or edge cases

  • Concurrency and session handling

The command records your answers in the specification. If [NEEDS CLARIFICATION] markers for policy decisions remain after the question limit, it recommends running /akka:clarify again rather than proceeding to /akka:plan.

Run this command iteratively until no further clarifications are needed.