project-discovery

Automate software project discovery and requirements specification into requirement-spec.md.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/dariopalminio/agile-sddf --skill project-discovery-dariopalminio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-discovery
Source: https://github.com/dariopalminio/agile-sddf/tree/main/.claude/skills/project-discovery
Command: npx skills add https://github.com/dariopalminio/agile-sddf --skill project-discovery-dariopalminio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This skill coordinates the Discovery phase of the ProjectSpecFactory, ensuring that user discovery and requirements specification are performed in a single guided session, producing docs/specs/project/requirement-spec.md.

Core Features & Use Cases

  • Orchestrates the discovery of user roles, needs, constraints, and business context from project-intent.md.
  • Delegates to project-pm and project-architect to synthesize a complete requirement-spec.md using assets/requirement-spec-template.md.
  • Supports retoma where an existing document exists and ensures safe overwrites with user confirmation.
  • Generates a final, metadata-rich docs/specs/project/requirement-spec.md ready for the planning phase.

Quick Start

Run a single session that merges user discovery with requirements specification to produce docs/specs/project/requirement-spec.md.

Frequently Asked Questions about project-discovery

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

FAQPage Schema
How do I automate discovery and requirements specification for software projects?

Automating discovery and requirements specification involves orchestrating a single guided session to extract user roles, needs, and constraints, producing a complete requirement-spec.md document. This skill coordinates the ProjectSpecFactory pipeline to synthesize business context into structured project requirements.

What is the best way to generate a requirement spec from project intent documentation?

Generating a requirement spec from project intent documentation requires parsing the initial project-intent.md file to identify workflows and constraints. The skill delegates to project management and architectural modules to synthesize this input into a metadata-rich requirement specification document.

Can I use an existing requirement spec document with the discovery workflow?

Yes, the discovery workflow supports resuming with an existing requirement spec document. If a file already exists, the system prompts for user confirmation to ensure safe overwrites before generating the updated metadata-rich requirement specification.

Does the requirements discovery process work without external dependencies?

Yes, the requirements discovery process operates without external dependencies, relying solely on internal project management and architectural delegation. It uses a runtime template to transform user roles and business context into a structured specification document.

How to identify user roles and business context during project discovery?

Identifying user roles and business context during project discovery happens by applying the ProjectSpecFactory pipeline to your initial project documentation. The system extracts flows and constraints, then delegates synthesis to project management and architectural components to finalize the requirements.

When do I need a guided discovery session for my software project requirements?

A guided discovery session for software project requirements is needed when transitioning from initial project intent to structured planning. It merges user discovery with requirements specification to produce a comprehensive requirement-spec.md ready for the next development phase.