ze-spec

Organize Ze specification development through scope, research, design, and write gates.

50|2|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/ze-software/ze --skill ze-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ze-spec
Source: https://github.com/ze-software/ze/tree/main/.codex/skills/ze-spec
Command: npx skills add https://github.com/ze-software/ze --skill ze-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ze spec workflow helps teams define, scope, and formalize design specs for changes in the Ze repository, reducing ambiguity and rework.

Core Features & Use Cases

  • Structured Gates: scope, research, design, and write gates guide spec progression from idea to implementation.
  • Resume & New Spec: detects existing specs and lets you resume or start a fresh spec with minimal friction.
  • Artifact Management: organizes plan documents, notes, and implementation-ready specs with traceability.

Quick Start

Open the Ze spec workspace and start a new spec or resume an existing one.

Frequently Asked Questions about ze-spec

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

FAQPage Schema
How do I structure a design spec workflow from research to implementation?

A structured spec workflow organizes development through sequential gates: scope, research, design, and write. This progression guides formal spec creation from initial idea framing to producing implementation-ready documentation, reducing ambiguity and rework.

What is the best way to manage and resume existing design specifications?

Spec management tools detect existing specifications and allow you to resume them or start a fresh spec with minimal friction. This maintains traceability across plan documents, notes, and implementation-ready artifacts within the repository.

How do I evaluate design approaches before writing an implementation-ready spec?

Evaluating design approaches occurs during the design gate phase of spec development. This stage follows initial scoping and research, allowing you to assess technical options and define the structure before producing the final implementation specification.

When do I need a gated specification process for repository changes?

A gated specification process is needed when repository changes require formal scope framing, dedicated research, and design evaluation. It ensures complex changes are formalized into implementation-ready specs, reducing ambiguity and preventing rework.

Does this spec workflow support framing project scope and conducting research?

Yes, the spec workflow explicitly includes scope and research gates. These initial stages handle framing the project boundaries and conducting necessary investigations before moving into design evaluation and writing the final specification.

What artifacts are generated by a structured spec development workflow?

A structured spec workflow generates organized plan documents, research notes, and implementation-ready specifications. These artifacts are managed with traceability throughout the scope, research, design, and write gates to ensure clear documentation.