skills.rest
alecanche04-cyber
alecanche04-cyberCOMMUNITY
Explore all skills by this author →
GitHub

architecting-solutions

Designs technical solutions and generates PRD documents for software implementation.

Updated Apr 14, 2026
Search Tags:#refactoring#technical design#requirements analysis#architecture design#solution design#code migration#prd
One-click install
npx skills add https://github.com/alecanche04-cyber/examenprograma --skill architecting-solutions-alecanche04-cyber
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecting-solutions
Source: https://github.com/alecanche04-cyber/examenprograma/tree/main/EXAMEN_PROGRA_2-master/.agents/skills/architecting-solutions
Command: npx skills add https://github.com/alecanche04-cyber/examenprograma --skill architecting-solutions-alecanche04-cyber

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns vague feature requests, refactoring needs, or bug investigations into structured architecture designs and implementation-ready PRD documents, preventing over-engineering and incomplete migration plans. ## Core Features & Use Cases - Structured Requirements Analysis: Clarifies user intent, success criteria, constraints, and existing codebase patterns before designing. - Multi-Option Solution Design: Proposes minimal, medium, and comprehensive solutions with documented trade-offs and asks for user approval before writing the PRD. - PRD Generation with Quality Checklists: Outputs a markdown PRD to the project's docs/ folder, validated against checklists covering root cause analysis, migration completeness, React hook rules, and backward compatibility. - Use Case: When asked to design a data refresh fix, it first greps the codebase for existing mechanisms, presents three solution options with risk levels, then writes a PRD only after the user picks an approach. ## Quick Start Ask the agent to design a technical solution for your feature or refactoring request, for example by saying "Design a solution for migrating our state management to a centralized store".

Frequently Asked Questions about architecting-solutions

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

FAQPage Schema
How do I create a PRD for a software feature?▼

Describe the feature or problem to the agent, which then clarifies requirements, analyzes your codebase for existing patterns, proposes multiple solution options with trade-offs, and writes a markdown PRD into your project's docs/ folder after your approval.

How to plan a code refactoring without over-engineering?▼

The skill enforces a minimal-first approach: it searches for existing mechanisms that already solve part of the problem, presents minimal, medium, and comprehensive options with file-change counts and risk levels, and only proceeds with the option you explicitly choose.

When should I use this instead of a PRD-specific planner?▼

Use this skill for general solution and architecture design requests like "design solution" or "technical design". The frontmatter explicitly routes PRD-specific work to the prd-planner skill instead.

Does it verify migration completeness for refactoring plans?▼

Yes. It includes checklists requiring all state to be accounted for, all consumers found via grep, all provider usage points updated, and backward compatibility with a clear migration path and deprecation timeline.

Why does the skill emphasize root cause analysis for bugs?▼

Its checklists prevent common mistakes like assuming hooks share state, leaving empty callbacks, or skipping steps in the call chain. It requires documenting the full trigger-to-effect chain with file paths and line numbers.

Related Skills

Explore More Software Engineering Skills→
aimentor606aimentor606

feature-spec

Generate structured product requirements documents with prioritized acceptance criteria.

Community
Intermediate
lis186lis186
46

impact-analyzer

Analyze code relationships to identify impacted files and migration needs.

Community
Basic
zinohomezinohome
1

api-test-suite-generator

Generate API test suites for Express, Next.js, and Fastify backends.

Community
Advanced
tmchowtmchow
22

iterative:spike

Scope uncertain questions and build throwaway artifacts to validate ideas.

Community
Advanced