arch-brainstorm

Generate a self-contained PRD with Mermaid diagrams from a domain area name.

5|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/russosalv/NONoise --skill arch-brainstorm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-brainstorm
Source: https://github.com/russosalv/NONoise/tree/main/packages/skills/arch-brainstorm
Command: npx skills add https://github.com/russosalv/NONoise --skill arch-brainstorm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Arch-brainstorm automates the initial, high-signal phase of architectural work by turning a domain area name into a self-contained PRD. It reads the project’s source of truth (docs/architecture, docs/requirements, docs/calls) and explores the codebase to surface context, constraints, and risks before drafting a narrative PRD.

Core Features & Use Cases

  • Reads constraints and patterns from the project knowledge bases and populates a complete PRD skeleton with a narrative decision story.
  • Scans the codebase to surface components, patterns, and gaps relevant to the study area and updates the area brief accordingly.
  • Produces PRD artifacts: NN-<study>.md with a frontmatter and an inline diagram, plus NN-<study>-diagrams.md for presentations, and updates 00-area-brief.md.

Quick Start

Provide the area slug to begin and the skill will generate a draft PRD along with diagrams and an area brief.

Frequently Asked Questions about arch-brainstorm

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

FAQPage Schema
How do I automate architectural brainstorming to draft a PRD?

Automated architectural brainstorming drafts a PRD by reading project source of truth in docs/architecture, docs/requirements, and docs/calls. It surfaces context, constraints, and risks to generate a narrative PRD with inline Mermaid diagrams and an area brief for validation.

What is the best way to generate a PRD with inline Mermaid diagrams?

Generating a PRD with inline Mermaid diagrams involves scanning the codebase to surface components and patterns, then producing a markdown file with frontmatter, an executive summary, architecture summaries, and data models, plus a dedicated diagrams file for presentations.

How do I create a narrative decision story for architecture documents?

Creating a narrative decision story for architecture documents requires exploring the codebase and project knowledge bases to surface constraints and gaps. The process records decisions in prose format within the PRD, incorporating context and architecture summaries.

Does architectural brainstorming work without existing docs/requirements?

Architectural brainstorming relies on existing project knowledge bases in docs/architecture, docs/requirements, and docs/calls to populate the PRD skeleton. Without these sources of truth, the skill cannot surface constraints or patterns to draft a complete narrative.

Can I use this to generate an area brief for Quint FPF validation?

Yes, generating an area brief for Quint FPF validation is a core output. The process updates a 00-area-brief.md file alongside the PRD and diagrams, ensuring the architectural study is ready for Quint FPF validation.

What limitations exist when drafting PRDs from codebase scanning?

Drafting PRDs from codebase scanning is limited by the quality of existing project sources in docs/architecture and docs/requirements. The tool cannot invent missing constraints or decisions, meaning incomplete source truth yields a partial narrative PRD.