What documents can this skill edit?

It is specifically designed to iterate on design discussion markdown files, typically following a standardized layout for architectural decision-making.

How does it verify user feedback?

The skill does not blindly accept changes; it spawns specialized sub-agents to analyze your codebase and verify patterns before updating the documentation.

Can it read feedback from external sources?

Yes, it can process feedback provided directly in the chat or read from specified ticket files containing comments from team members.

Does it support GitHub integration?

Yes, it includes built-in support for generating GitHub permalinks to help team members quickly navigate to the updated sections of your documentation.

Design Discussion Architect

Name: Design Discussion Architect
Author: mshuffett

bymshuffett

0•

Collaboration Tools

Refines software design documents by incorporating user feedback, resolving open questions, and conducting deep-dive technical research.

This skill streamlines the architectural review process by managing and updating design discussion documents. It automatically processes user feedback from local files or ticket comments, validates proposed changes through specialized research sub-agents (codebase-locator, analyzer, and pattern-finder), and updates technical patterns and constraints accordingly. By moving resolved questions to a dedicated section and generating GitHub permalinks for easy navigation, it ensures your technical documentation remains a live, accurate reflection of your project's architectural decisions.

Key Features

01Autonomous research sub-agents for codebase verification

02Automatic updating of technical patterns and constraints

03Automated feedback processing from documents or ticket files

04GitHub permalink generation for seamless document sharing

05Smart resolution of design questions with rationale

060 GitHub stars

Use Cases

01Updating technical RFCs or design docs after team reviews

02Validating proposed design changes against existing codebase patterns

03Closing the loop on open architectural questions during the planning phase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mshuffett/dotfiles iterate-design-discussion

For use in Claude.ai and ChatGPT

Download Skill