issue-design

Draft design documents from issues into the draft/design directory.

12|1|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/apokamo/kaji --skill issue-design-apokamo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-design
Source: https://github.com/apokamo/kaji/tree/main/.claude/skills/issue-design
Command: npx skills add https://github.com/apokamo/kaji --skill issue-design-apokamo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drafting and archiving comprehensive design documents for Issues in the worktree, ensuring design work is organized, traceable, and ready for handoff.

Core Features & Use Cases

  • Structured design templates guiding Input, Output, Constraints, and Testing strategies.
  • Worktree-aware drafting that ties to Issue IDs and supports BACK-driven restart flows.
  • Centralized archival of design artifacts in draft/design for review and reference.

Quick Start

Create a draft design document for a given issue and store it under draft/design following the issue-driven workflow.

Frequently Asked Questions about issue-design

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

FAQPage Schema
How do I draft design documents from issues for review?

Drafting design documents from issues requires encoding steps, inputs, and ownership into a single artifact stored in a draft/design directory. This approach enforces standardized templates to ensure documents are ready for validation and handoff.

What is a structured design template for issue-driven workflows?

A structured design template for issue-driven workflows organizes Input, Output, Constraints, and Testing strategies. It centralizes archival of design artifacts in a draft/design directory for review and reference.

How do I coordinate design work with BACK-driven restart flows?

To coordinate design work with BACK-driven restart flows, encode all steps, inputs, and ownership in a single design artifact. This worktree-aware approach ties drafts to Issue IDs for continuity.

Does issue-driven design drafting work without external dependencies?

Yes, issue-driven design drafting operates without external dependencies. It generates standardized design artifacts in the worktree, specifying testing and completion protocols internally.

What is the best way to standardize design documentation for handoff?

The best way to standardize design documentation for handoff is enforcing a standardized template that specifies testing and completion protocols. Store artifacts centrally in a draft/design directory for review.

Why does issue design drafting require a dedicated draft/design directory?

Issue design drafting requires a dedicated draft/design directory to centralize archival of design artifacts, ensuring they remain organized and traceable for review and handoff.