Can I customize the output format?

The skill uses markdown templates located in the project's reference directory to ensure all design discussions follow your team's specific standards.

How does the skill handle deep codebase research?

It spawns parallel sub-tasks using specialized agents like codebase-locator and codebase-pattern-finder to identify existing conventions and dependencies.

Does this skill work with symlinked directories?

Yes, it is specifically designed to use Bash commands that traverse symlinks in task directories where standard search tools might fail.

What is the Design Discussion Phase?

It is the structured planning step where research findings are turned into actionable design decisions before implementation begins.

Design Discussion Planner

Name: Design Discussion Planner
Author: mshuffett

bymshuffett

0•

Collaboration Tools

Orchestrates the architectural planning phase by synthesizing research findings into structured, pattern-based design documents.

This skill facilitates the critical transition from research to implementation by enforcing a rigorous design discussion workflow. It guides Claude to exhaustively read task context, spawn specialized sub-tasks for deep codebase analysis, and collaborate with the user on architectural decisions. By identifying existing patterns and verifying all user feedback against the live codebase, it ensures that implementation plans are technically sound and documented using standardized templates with GitHub permalinks for full traceability.

Key Features

010 GitHub stars

02Symlink-aware directory traversal for robust task management

03Parallel research sub-tasks for codebase analysis and pattern finding

04Integrated GitHub permalink generation for easy document navigation

05Automated generation of standardized design discussion markdown files

06Template-based architectural decision recording with pros and cons

Use Cases

01Validating proposed changes against existing codebase patterns and conventions

02Standardizing design documentation across a team using consistent templates

03Defining technical architecture for complex features before starting implementation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mshuffett/dotfiles create-design-discussion

For use in Claude.ai and ChatGPT

Download Skill