kata-ideation-from-insight

Promote approved discovery insights into a structured Idea artifact with rollback.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-ideation-from-insight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-ideation-from-insight
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-ideation-from-insight
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-ideation-from-insight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts approved product discovery insights into a structured Idea artifact (problem, hypothesis, target user, success metric, effort estimate) and promotes the linked insights safely, without mixing topics.

Core Features & Use Cases

  • Approved-insight promotion workflow: Reads one or more source insights and synthesizes the required Idea fields before writing anything.
  • Hard-gated validation with rollback: Enforces preconditions (approved status, same topic, non-empty mandatory fields) and performs a transactional rollback to prevent orphan Ideas or mismatched promotions.
  • Discovery documentation output: Writes the new Idea to docs/discovery/{topic}/ideas/ and updates each source insight’s status to promoted with idea_ref and updated_at only.

Quick Start

Use the kata-ideation-from-insight skill with an insight_path containing approved insights from a single topic to generate the next Idea file and promote the linked insights.

Frequently Asked Questions about kata-ideation-from-insight

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

FAQPage Schema
How do I convert approved product discovery insights into structured ideas?

To convert approved product discovery insights into structured ideas, this skill synthesizes the problem, hypothesis, target user, success metric, and effort estimate fields into a new Idea artifact under docs/discovery/{topic}/ideas/.

What happens if insight promotion fails during idea generation?

If insight promotion fails during idea generation, the skill executes a transactional rollback to prevent orphan Ideas or mismatched promotions, ensuring data consistency across your product discovery documentation.

Can I promote approved insights from multiple different topics into one idea?

No, you cannot promote approved insights from multiple topics into one idea. The skill enforces preflight validation requiring topic consistency, ensuring only insights from a single topic are consolidated.

What mandatory fields are required to generate an idea from insights?

Generating an idea from insights requires substantive mandatory fields including problem, hypothesis, target user, success metric, and effort estimate, which are synthesized from the approved source insights.

How are source insights updated after creating a new idea artifact?

After creating a new idea artifact, source insights are updated by setting their status to promoted and adding an idea_ref and updated_at timestamp, without modifying any other original insight data.

Does the idea generation process validate insight status before promotion?

Yes, the idea generation process enforces preflight validation for insight status, ensuring only approved insights are eligible for promotion into the structured Idea artifact.