ze-design

Coordinates Ze repository design decisions grounded in repo rules and maintains a running decision log.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ze design coordinates decisions for repository planning and ensures all recommendations stay aligned with existing constraints and code patterns, reducing drift and rework.

Core Features & Use Cases

  • Grounded in repo rules: Binds every recommendation to CLAUDE.md, AGENT.md, ai/INDEX.md, and applicable ai/rules.
  • One-decision-at-a-time: Breaks complex problems into single, testable decisions with explicit trade-offs.
  • Decision log persistence: Maintains a running log of decisions for traceability and reuse in specs.

Quick Start

Propose a design approach for the requested feature in Ze that strictly follows repo rules and existing code patterns, documenting each decision in a running log.

Frequently Asked Questions about ze-design

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

FAQPage Schema
How do I ensure architectural design decisions stay aligned with existing repository rules?

You can ground architectural design decisions in repository rules by binding every recommendation to configuration files like CLAUDE.md and AGENT.md. This ensures alignment with existing constraints and code patterns, reducing drift and rework.

What is the best way to maintain a decision log for feature design reviews?

Maintaining a decision log for feature design reviews involves documenting each architectural choice in a persistent running log. This provides traceability for policy alignment and allows reuse of past decisions in future specifications.

How do I break down complex architectural discussions into testable decisions?

Break down complex architectural discussions by evaluating one decision at a time with explicit trade-offs. This stepwise approach ensures each recommendation is verifiable and grounded in established repository constraints.

Can I apply repo guidance to evaluate code patterns before proposing a new feature design?

Yes, you can apply repo guidance to evaluate existing code patterns before proposing a feature design. It checks recommendations against applicable rules within the codebase to ensure new features do not violate established policies.

Why does my repository planning experience drift from established constraints?

Repository planning experiences drift when recommendations are not strictly bound to applicable rules and existing code patterns. Applying grounded design reviews with a persistent decision log resolves this by enforcing policy alignment.

When should I not use a stepwise approach for architectural design reviews?

You should avoid a stepwise approach for architectural design reviews when immediate, holistic decisions are required without explicit trade-off analysis, as this method specifically breaks problems into single, testable decisions.