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

Collaboration Tools

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

About

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

Autonomous research sub-agents for codebase verification
Automatic updating of technical patterns and constraints
Automated feedback processing from documents or ticket files
GitHub permalink generation for seamless document sharing
Smart resolution of design questions with rationale
0 GitHub stars

Use Cases

Updating technical RFCs or design docs after team reviews
Validating proposed design changes against existing codebase patterns
Closing the loop on open architectural questions during the planning phase

About

Key Features

Autonomous research sub-agents for codebase verification
Automatic updating of technical patterns and constraints
Automated feedback processing from documents or ticket files
GitHub permalink generation for seamless document sharing
Smart resolution of design questions with rationale
0 GitHub stars

Use Cases

Updating technical RFCs or design docs after team reviews
Validating proposed design changes against existing codebase patterns
Closing the loop on open architectural questions during the planning phase