Where are the generated specifications stored?

All specifications are saved in timestamped directories within '.claude/tasks/', creating a persistent and searchable history of your project's technical decisions.

Can I use this skill without answering questions every time?

Yes, by using the '-n' or '--noask' flag, the skill will skip user interaction, auto-approve defaults, and infer the scope entirely from codebase analysis.

What happens if a task is too large for a single specification?

The skill includes a 'Feature Splitting Check' that evaluates complexity and will suggest breaking the work into multiple smaller, manageable tasks if the scope is too broad.

What is the Brewcode Spec skill?

It is a specialized Claude Code capability that automates the creation of detailed technical specifications by researching your codebase and facilitating interactive requirements gathering.

How does parallel research improve task planning?

It launches multiple specialized agents (developer, tester, reviewer, etc.) to analyze different parts of your project simultaneously, providing a holistic view of how a change affects the entire system.

Brewcode Task Specifier

Name: Brewcode Task Specifier
Author: kochetkov-ma

bykochetkov-ma

•

Productivity & Workflow

Generates comprehensive technical specifications and architectural plans through automated codebase research and interactive user clarification.

Brewcode Spec is a sophisticated planning tool for Claude Code that transforms vague task descriptions into detailed, actionable technical specifications. By deploying a swarm of specialized parallel agents—including developers, testers, and reviewers—the skill analyzes your codebase to identify affected modules, risks, and implementation patterns. It intelligently handles high-complexity features by suggesting logical task splits and produces a project-standardized SPEC.md file, ensuring every coding session starts with a clear, validated roadmap and deep contextual awareness.

Key Features

01Quality-Assured Output: Includes an automated reviewer loop to ensure specifications are complete, consistent, and technically feasible.

0216 GitHub stars

03Codebase-Aware Analysis: Maps task requirements directly to existing file patterns, services, and repository structures.

04Automated Feature Splitting: Detects high-complexity requirements and proposes breaking them into manageable, independent sub-tasks.

05Interactive Requirement Gathering: Conducts structured Q&A sessions to clarify scope, constraints, and edge cases before work begins.

06Parallel Multi-Agent Research: Orchestrates specialized agents to analyze architecture, services, and tests simultaneously.

Use Cases

01Standardizing project documentation by ensuring all tasks follow a consistent, peer-reviewed specification template.

02Reducing technical debt by identifying architectural risks and edge cases during the planning phase.

03Kickstarting complex features by generating a technical roadmap before writing any implementation code.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kochetkov-ma/claude-brewcode spec

For use in Claude.ai and ChatGPT

Download Skill