Architecting Solutions
This is essentially a PRD generator wrapped in architectural planning. It walks Claude through a structured workflow: clarify requirements, analyze the existing codebase, design a solution with multiple options (minimal, medium, comprehensive), and output a markdown PRD to your project's docs folder. The source is heavily opinionated about avoiding over-engineering, with multiple warnings to look for existing mechanisms before proposing refactors and to always present trade-offs. Worth noting that it includes specific checklist items for debugging refresh logic and state management, suggesting it was built to solve real footguns the author encountered. If you need structured technical specs rather than ad-hoc brainstorming, this gives you that framework.
- skills.sh installs
- 788
- GitHub stars
- 66
- last updated
- Jul 14, 2026
Install
$ npx -y skills add charon-fan/agent-playbook --skill architecting-solutions --agent claude-codeInstalls into .claude/skills of the current project.
Files
Architecting Solutions
Analyzes requirements and creates technical solution documents for software implementation.
Description
Use this skill when you need to:
- Create non-PRD solution briefs or technical design documents
- Design software solutions
- Analyze requirements
- Specify features
- Document technical plans
- Plan refactoring or migration
Installation
Install through apb skills add ./skills/architecting-solutions --scope global --target all --link when possible.
How It Works
The skill guides Claude through a structured workflow:
- Clarify requirements - Ask targeted questions to understand the problem
- Analyze context - Review existing codebase for patterns and constraints
- Design solution - Propose architecture with trade-offs considered
- Generate solution doc - Output a markdown solution brief or technical design to
{PROJECT_ROOT}/docs/
IMPORTANT: Use prd-planner when the user asks for a PRD. This skill writes non-PRD architecture and solution artifacts to the project's docs/ folder.
Workflow
Copy this checklist and track progress:
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/charon-fan/agent-playbook
- Category
- AI & Agent Building
- First seen
- May 16, 2026
More from charon-fan/agent-playbook
All 24- Skill Router780
- Prd Planner742
- Test Automator736
- Figma Designer729
- Workflow Orchestrator726
- Session Logger680
- Debugger678
- Qa Expert678
- Code Reviewer665
- Refactoring Specialist663
- Prd Implementation Precheck646
- Api Documenter641
- Api Designer639
- Documentation Engineer630
- Performance Engineer629
- Auto Trigger628
- Commit Helper619
- Deployment Engineer611
- Create Pr600
- Long Task Coordinator599
- Self Improving Agent31.9K
- Planning With Files1.1K
- Security Auditor950
Recommended
More AI & Agent Building
scaffold-nextjsmblode/agent-skillsScaffolds a production-ready Next.js turborepo end to end. Runs create-next-app with TypeScript 7, Tailwind CSS, React Compiler, and Cache Components, sets up s785skills.sh installs
analyzing-api-gateway-access-logsmukul975/anthropic-cybersecurity-skillsParses API Gateway access logs (AWS API Gateway, Kong, Nginx) to detect BOLA/IDOR attacks, rate limit bypass, credential scanning, and injection attempts. Uses 782skills.sh installs
web-searchjwynia/agent-skillsSearch the web using the agent's built-in WebSearch tool. Use when you need to find current information, verify facts, or research topics. No API key required. 780skills.sh installs
web-to-markdownsoftaworks/agent-toolkitUse ONLY when the user explicitly says: 'use the skill web-to-markdown ...' (or 'use a skill web-to-markdown ...'). Converts webpage URLs to clean Markdown by c780skills.sh installs