req-docs/

Документы требований: PRD, BRD, FRD

Работает в два этапа: сначала советует, какие документы с требованиями нужны проекту (PRD, BRD, FRD, MRD, SRD, TRD, QRD), затем пишет их по шаблонам.

Автор: alenazaharovauxОбновлён Бесплатно

Ставится на компьютере

С телефона скилл не поставить: Claude Code работает на Windows, macOS и Linux. Отправьте ссылку себе и откройте её на компьютере.

Что нужно: компьютер и Claude Code — он работает с подпиской Claude Pro и выше, на бесплатном плане его нет. Как поставить Claude Code →

Карточка

Имя папки
req-docs
Раздел
Продукт
Автор
alenazaharovaux
Обновлён
Инструкция
на английском, задачу ставите по-русски
Файлы
  • SKILL.md
  • references/ · 13 файлов

Похожие скиллы

Подобраны по смыслу описания, а не по алфавиту.

  • Разработка
    Совместное редактирование документов

    Для авторов: совместное создание docs с этапами сбора контекста, структурирования и тестирования

    doc-coauthoring · anthropics

  • Разработка
    Допрос плана с документацией

    Жёсткое интервью по плану или дизайну, по ходу которого Claude пишет глоссарий и ADR.

    grill-with-docs · mattpocock

  • Разработка
    Документировщик кода

    Документирует код, API и руководства по нужным стандартам.

    code-documenter · Jeffallan

  • Разработка
    Конвертация документов в Markdown

    Преобразование файлов и документов в Markdown с помощью Claude Code. Поддержка PDF, DOCX, PPTX, XLSX, изображений (с OCR), аудио (с распознаванием речи).

    markitdown · K-Dense-AI

  • Продукт
    Frontend Архитектор

    Для фронтенд-разработчиков: создаёт уникальные, запоминающиеся интерфейсы без шаблонности

    frontend-design · anthropics

  • Продукт
    Структура сайта

    Планирует структуру сайта: иерархию страниц, навигацию, URL и перелинковку.

    site-architecture · coreyhaines31

Статьи по теме

Текст инструкции · SKILL.md

Оригинал инструкции (англ.)

Это оригинал автора на английском. Переводить его не нужно: Claude читает инструкцию сам, а задачу вы ставите ему по-русски.

A skill for determining which requirement documents a project needs and writing them. Works in two phases: advisor (recommend documents) → writer (create documents from templates).

Supports 7 document types: PRD, BRD, FRD, MRD, SRD, TRD, QRD with 13 template variations.

Phase Auto-Detection

Before starting, determine which phase to enter:

  1. Search for **/req-docs-plan.md in the project root and docs/ directory (exact name, no fuzzy matching)
  2. If found and has pending documents → start Phase 2 (Writer), offer to write the next pending document
  3. If not found → start Phase 1 (Advisor)
  4. If user explicitly names a document type ("write me a PRD") → confirm: "Are you sure you need specifically a PRD, or would you like me to help determine which documents your project needs?"

Phase 1: Advisor

Goal: determine which documents the project needs, in what order.

Step 1: Project Context

Read project files (README, package.json, CLAUDE.md, existing specs/docs). Understand what the product is, tech stack, stage, existing documents.

Existing documents detection: scan for files matching *PRD*.md, *BRD*.md, *FRD*.md, *MRD*.md, *SRD*.md, *TRD*.md, *QRD*.md, *requirements*.md, *-spec.md, *specification*.md. If found — read them, determine type and completeness. Report to user: "I found an existing PRD in docs/prd.md. I recommend complementing it with an FRD for the development team."

Step 2: Clarifying Questions

Ask questions one at a time. Skip questions whose answers are obvious from context. Every question includes "Not sure / Not defined yet" as a valid option.

For newcomers: include a brief explanation of why each question matters.

  1. What product? (skip if obvious from context)
  2. Stage? Idea / Discovery / MVP / Growth / Scale / Not sure yet
  3. Document audience? Investors / Product team / Developers / AI agent / Contractor / Not sure
  4. Methodology? Waterfall / Agile / Hybrid / No formal process / Not sure
  5. Team size? Solo / Startup (3-10) / Agile team (10-30) / Enterprise (50+) / Not sure
  6. Regulatory requirements? Fintech, healthcare, defense, government — or none / Not sure
  7. Budget estimate? Under $10K / $10K-100K / $100K-1M / Over $1M / Not defined yet

"Not sure" signals early stage → recommend lighter documents (MVP PRD, Lean BRD).

Search triggers: if the user names a specific domain (fintech, healthcare, defense, IoT) → offer to search for regulatory requirements that affect document structure. If competitors named → offer to search their approach. Use whatever search tools are available; if none, suggest specific things the user should research.

Step 3: Decision Matrix

SituationRecommended Documents
Idea + leadership audienceMRD
Investment justificationBRD
Product team, any scalePRD
Technical spec for developersFRD
Full system specificationSRD
Infrastructure/platform requirementsTRD
Formal quality standardsQRD
Regulated (fintech, healthcare)PRD + FRD + SRD
Regulated + enterpriseBRD → PRD → FRD → SRD + TRD + QRD
Startup, quick validationMVP PRD
AI agent (Cursor, Claude Code)AI-Optimized PRD
Microservices / API productPRD + API FRD
Infrastructure team documenting platformTRD
Healthcare/regulated needing quality standardsQRD (alongside SRD)
Hardware productPRD (Hardware) + TRD + QRD

If PRD recommended → determine variation: Standard, One-Pager, MVP, Feature, Technical, AI-Optimized, Hardware, API, Agile.

Step 4: Recommendation

Present to user:

  • Which documents are needed and why (for newcomers: one-sentence explanation of each type)
  • Recommended writing order (dependency chain: MRD → BRD → PRD → FRD → SRD, TRD and QRD parallel to SRD)
  • What already exists and how new documents complement it
  • Confidence level: if answers were clear → confident. If many "not sure" → honest: "I recommend starting with MVP PRD. If the project grows, come back for FRD and SRD."
  • Ask for confirmation before proceeding

Step 5: Save Plan

After confirmation, write docs/req-docs-plan.md:

# Required Documents — [Project Name]

## Context
- Product: [description from Step 1-2]
- Stage: [stage]
- Team: [size, methodology]
- Audience: [who the documents are for]
- Regulatory: [requirements or none]
- Save path: [to be set in Phase 2]

## Documents
1. **[TYPE]** ([Variation]) — pending
2. **[TYPE]** ([Variation]) — pending

## Order Rationale
[Why this order — dependency chain explanation]

## Existing Documents
- [path] — [type, completeness assessment]

Then transition to Phase 2 or ask if the user wants to continue later.

Phase 2: Writer

Goal: write documents one at a time using templates + project context.

Entry

  1. Read docs/req-docs-plan.md
  2. Re-read project files — context may have changed since Phase 1
  3. Find first document with status pending
  4. Offer: "Next document is [TYPE]. Start?" (user can pick a different one)
  5. On first document: ask save path. Default docs/. If the project has a different convention, suggest that. Store path in plan file for subsequent documents.

Writing Process (per document)

Step 1: Load template. Read the corresponding template from references/templates/. Templates available:

TemplateFile
PRD Standardprd-standard-template.md
PRD MVPprd-mvp-template.md
PRD AI-Optimizedprd-ai-optimized-template.md
BRD Standardbrd-standard-template.md
BRD Leanbrd-lean-template.md
FRD Standardfrd-standard-template.md
FRD APIfrd-api-template.md
MRD Standardmrd-standard-template.md
MRD Startupmrd-startup-template.md
SRD Standardsrd-standard-template.md
SRD Agilesrd-agile-template.md
TRD Standardtrd-standard-template.md
QRD Standardqrd-standard-template.md

For PRD variations without a dedicated template (One-Pager, Feature, Technical, Hardware, API, Agile), adapt the Standard PRD template:

VariationRemoveAdd
One-PagerWireframes, Technical Approach, Timeline(condense to 1 page)
FeatureMarket contextFeature dependencies, rollback plan
TechnicalMarket context, personasArchitecture, API specs, data models
Hardware—BOM, certifications, manufacturing
APIPersonas, wireframesEndpoints, schemas, rate limits (merge with API FRD)
AgileTimeline, formal sign-offSprint mapping, story points

Step 2: Fill with context. Use project context (freshly scanned) + advisor answers (from plan file).

Rules:

  • Fill sections with real data from context where possible
  • Where data is missing → write [TBD] and add to Open Questions section
  • Never invent metrics, numbers, competitor names — only what is known
  • Generate user stories independently but mark: "Requires validation with team"
  • Prioritize requirements (P0/P1/P2) based on context but suggest review
  • Add cross-references to already-written documents: See [Type] §[Section] (path/to/file.md)

Step 3: Targeted questions. If key sections critically lack data → ask the user (max 3-4 questions). If user doesn't know → leave TBD, don't block the process.

Step 4: Self-check.

Generic checks:

  • All required sections filled or marked TBD
  • Problem Statement based on facts, not assumptions
  • Scope contains both IN and OUT
  • Success Metrics specific and measurable (or TBD)
  • No duplication with existing project documents
  • No invented data
  • Cross-references correct
  • Document length within range (MVP PRD: 2-4 pages, Standard PRD: 5-15, BRD: 5-20, FRD: 10-50, SRD: 10-50, TRD: 5-15, QRD: 5-10)

Type-specific checks:

TypeChecks
PRDUser stories "As a [role]..." format, Scope has IN/OUT, SMART metrics
BRDProblem cites data not opinions, cost-benefit present or TBD, ROI justified
FRDUnique IDs (FR-001), "shall/should" language, error states described
MRDTAM/SAM/SOM present or TBD, user segments specific
SRDNFRs quantified (ms, %, count), architecture not empty, data model described
TRDSoftware versions specified, licenses noted, capacity planning
QRDBlocking/advisory split, each attribute has measurement method

Step 5: Present to user. Write document to file, show, ask:

  • What needs to change?
  • Which TBDs can we fill now?
  • Is the document ready?

Step 6: Update plan. Mark document as done in plan, record file path. Offer: "Next document is [TYPE]. Continue now or come back later?"

Error Handling

  • Malformed plan file: offer to re-run Phase 1 and rebuild
  • Pending document whose file already exists: ask overwrite or skip
  • All documents done: congratulate, offer to review the full set or add new documents
  • Stale context: on Phase 2 re-entry, if project files changed significantly since plan was created → warn user, offer to re-run advisor

Language

Determined by user's language. If unclear, ask. Templates are in English (industry standard for requirement documents). Content sections are written in the user's language. Section headers remain in English (e.g., "## Problem Statement") regardless of content language.

What This Skill Does NOT Do

  • Does not replace user/market research
  • Does not generate wireframes or mockups
  • Does not make decisions for the user — proposes and explains
  • Does not invent data — uses what is known, marks the rest as TBD