project-brief-writer

Transform rough project ideas into problem-focused briefs with structured handoff artifacts.

Updated Dec 5, 2025
One-click install
npx skills add https://github.com/JHaugaard/refine-workflow-skills --skill project-brief-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-brief-writer
Source: https://github.com/JHaugaard/refine-workflow-skills/tree/main/skills-working-copies/project-brief-writer
Command: npx skills add https://github.com/JHaugaard/refine-workflow-skills --skill project-brief-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users often struggle to define project ideas clearly, frequently over-specifying technical details too early. This "PRD Quality Paradox" stifles learning opportunities and biases future decisions. This skill guides you to articulate the problem and goals without prematurely locking in technical solutions.

Core Features & Use Cases

  • Problem-Focused Briefs: Guides you to define what to build and why, not how, ensuring clarity and purpose.
  • Learning Mode Integration: Automatically creates PROJECT-MODE.md to align the entire workflow with your learning or delivery goals.
  • Over-Specification Detection: Identifies and quarantines premature technical decisions, preserving valuable learning opportunities for downstream skills like tech-stack-advisor.
  • Workflow Initiation: Serves as the crucial first step in a structured project workflow, seamlessly feeding into subsequent planning and setup skills.

Quick Start

Use the project-brief-writer skill to create a new project brief for my idea: "Build a tool to manage my personal finances."

Frequently Asked Questions about project-brief-writer

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

FAQPage Schema
How do I turn a rough project idea into a clear brief without over-specifying technical details?

Project-brief-writer transforms rough ideas into problem-focused briefs that define *what* to build and *why*, while deferring technical decisions. It guides you through structured ideation to capture goals and requirements without prematurely locking in implementation choices, preserving learning opportunities for downstream planning skills.

What's the difference between writing a project brief and a technical specification?

A project brief defines the problem, goals, and functional requirements—the *what* and *why*. A technical specification details *how* to solve it. This skill keeps briefs problem-focused to avoid the PRD Quality Paradox, where premature technical decisions stifle exploration and bias future choices.

Can I use project briefs in a learning workflow, or are they only for delivery?

Project briefs work for both learning and delivery workflows. The skill automatically creates PROJECT-MODE.md to align your entire workflow with learning or delivery goals, ensuring briefs adapt to your context and support the structured steps that follow.

How do I capture non-technical project requirements and preferences in a brief?

Project-brief-writer exports structured artifacts—brief.json, PROJECT-MODE.md, and project-specific markdown files—that capture functional requirements and non-binding user preferences while quarantining premature technical details for later refinement by downstream skills.

When should I start using a project brief in my planning workflow?

Use project-brief-writer at the crucial first step of structured project workflow, during early-stage ideation and non-technical planning. It serves as the foundation that feeds seamlessly into subsequent planning and setup skills like tech-stack-advisor.

What does over-specification detection do during brief creation?

Over-specification detection identifies and isolates premature technical decisions—deployment choices, stack preferences, or architectural assumptions—so they don't constrain learning opportunities. This preserves flexibility for downstream skills to make informed technology choices based on problem definition.