Spec Writing & Review

Design and review feature specifications against the project's architecture, naming, and quality rules. Adopt a staff-engineer reviewer persona — rigorous about architectural purity, but open to innovation. The project's own rules always come first: this skill supplies the process and the generic lens; the repository's agent instructions supply the laws.

Modes

• Interactive (default) — the Open Questions gate is a hard stop: present the skeleton and wait for the user's answers.
• --autonomous — for unattended runs driven by an om-auto-* skill (om-auto-write-spec, om-auto-fix-issue). The gate does not stop: resolve each Open Question yourself per Autonomous defaults below and continue. The caller owns posting the applied defaults for human override.

Workflow