suggest

Detect complexity signals in software requests and recommend a multi-phase engineering workflow.

2|1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Epiphytic/brains --skill suggest-epiphytic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: suggest
Source: https://github.com/Epiphytic/brains/tree/main/skills/suggest
Command: npx skills add https://github.com/Epiphytic/brains --skill suggest-epiphytic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects when a user's request contains sufficient complexity that a structured, multi-phase engineering workflow (BRAINS) would reduce risk, clarify requirements, and improve design decisions instead of proceeding with ad-hoc implementation.

Core Features & Use Cases

  • Signal-based detection: Evaluates requests against a checklist of complexity signals (multi-component scope, cross-cutting concerns, architectural choices, unfamiliar codebase, integration risk, security surface, ambiguous requirements, greenfield work).
  • Advisory recommendations: Produces concise, tailored suggestions that name the specific signals observed and recommend invoking the BRAINS workflow without auto-invoking it.
  • Use Case: When an engineer describes a feature that spans services, touches authentication, and requires architectural tradeoffs, use this Skill to propose BRAINS for structured research, planning, and implementation.

Quick Start

Ask the assistant to evaluate your request and recommend the BRAINS workflow when multiple complexity signals are present.

Frequently Asked Questions about suggest

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

FAQPage Schema
How do I know if a software engineering task is complex enough to need a structured workflow?

Task complexity is detected by analyzing explicit and implicit signals in a request, such as multi-component scope, cross-cutting concerns, architectural decisions, unfamiliar codebase, integration risk, security surface, ambiguous requirements, and greenfield work. When two or more signals are present, a structured workflow is recommended.

What is a multi-phase engineering workflow and when should I use one?

A multi-phase engineering workflow is a structured approach to reduce risk, clarify requirements, and improve design decisions. Use it for software engineering scenarios involving multi-component changes, integration or security-sensitive work, and architectural decisions where ad-hoc implementation would be too risky.

How do I evaluate a user request to recommend a coordinated engineering workflow?

Evaluate the request against a checklist of complexity signals. If the request touches multiple components, involves architectural tradeoffs, or requires security-sensitive work, enumerate the observed signals and issue an advisory recommendation proposing a coordinated workflow without auto-invoking it.

Does the BRAINS workflow recommendation auto-invoke when multiple complexity signals are detected?

No, the BRAINS workflow recommendation is advisory-only. It produces concise, tailored suggestions that name the specific complexity signals observed and recommends invoking the workflow manually, but it does not auto-invoke any skill.

Can I use complexity detection for cross-cutting concerns in an unfamiliar codebase?

Yes, complexity detection evaluates requests for cross-cutting concerns and unfamiliar codebase signals. When these signals meet a two-or-more threshold, it recommends a structured workflow to handle the research, planning, and implementation for the unfamiliar codebase.