trellis-brainstorm

Guides requirements discovery and produces PRD, design, and implementation planning artifacts.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-brainstorm-silentflower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-brainstorm
Source: https://github.com/SilentFlower/flower-trellis/tree/main/.agents/skills/trellis-brainstorm
Command: npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-brainstorm-silentflower

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns vague feature requests and complex tasks into clear, reviewed requirements before any code is written, preventing premature implementation and scope drift. ## Core Features & Use Cases - Structured Discovery: Creates a task directory, seeds prd.md, inspects repository evidence first, and asks only one high-value user-owned question per turn. - Planning Artifacts: Produces prd.md, plus design.md and implement.md for complex tasks, with a lossless PRD convergence pass and a requirement convergence gate. - Gated Handoff: Refreshes a final Brief via trellis-task-brief and blocks task.py start until explicit planning review approval. - Use Case: When a user says "add caching to the profile endpoint", the skill explores the codebase, clarifies scope and acceptance criteria, and delivers an approved plan before implementation begins. ## Quick Start Ask the AI to plan a new feature using the trellis-brainstorm skill before writing any code.

Frequently Asked Questions about trellis-brainstorm

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

FAQPage Schema
How do I plan a feature before implementing it with an AI agent?▼

Invoke the brainstorming workflow to create a task directory and seed a prd.md file. The skill inspects repository evidence, asks one high-value question at a time, and converges on scope before any implementation begins.

What artifacts does Trellis planning produce?▼

Lightweight tasks produce prd.md with requirements and acceptance criteria. Complex tasks additionally require design.md for architecture and implement.md for an ordered execution checklist before task.py start is allowed.

When should I use brainstorming instead of starting implementation directly?▼

Use it when requirements are unclear, multiple valid approaches exist, or the user describes a new feature or complex task. Simple, fully specified requests with no unresolved user-owned decisions can proceed without extended discovery.

Can implementation start right after the user approves task creation?▼

No. Task-creation consent and general implementation intent authorize planning only. Implementation requires the final Brief review gate defined by trellis-task-brief, or explicit preauthorization for the unchanged final Brief.

Why does the skill ask only one question per message?▼

Single-question turns keep decisions focused and ensure each answer updates prd.md before the next decision is computed. Questions must target user-owned product, scope, or risk decisions, not facts answerable from the repository.