Skills
.Work. You
Rest

needs-design

Official

Create living feature designs that guide delivery.

Software Engineering#architecture#documentation#adr#system-design#feature-design#needs-design
Authorprovenimpact
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill helps product teams and engineers create a coherent, living design document that maps user stories and specs to a concrete implementation plan, ensuring ADRs and constraints are considered and traceable throughout a feature's lifecycle.

Core Features & Use Cases

  • Phase 0: Research and Decisions guidance to identify technology choices, unknowns, dependencies, and integration with ADRs.
  • Phase 1: Design guidance for system architecture, data models, interfaces, and story mapping, with requirements to produce design.adoc per feature.
  • Sync and maintenance workflows to keep design in line with evolving stories/specs and ADR updates.
  • Use Case: when starting a new feature, run the orchestrator to generate a design doc that captures decisions, constraints, and a structured implementation plan.

Quick Start

Create a new design for a feature by running the Proven Needs orchestration and populate docs/features/<slug>/design.adoc with system, data, interfaces, and story resolution.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: needs-design
Download link: https://github.com/provenimpact/proven-needs/archive/main.zip#needs-design

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.