software-architecture-skills

A platform-neutral software architecture skill pack for exploring architectural options, documenting tradeoffs, defining boundaries, and writing reusable architecture artifacts.

Included skills

• adr-writer
• architecture-option-generator
• architecture-risk-assessor
• availability-strategy-reviewer
• component-boundary-reviewer
• deployment-view-writer
• integration-boundary-mapper
• layered-architecture-designer
• monolith-vs-modular-monolith-reviewer
• quality-attribute-scenario-writer
• runtime-view-writer
• scalability-hotspot-detector
• service-decomposition-advisor
• tradeoff-analysis-writer

Features

• Preserves the original skills/, templates/, and examples/ source material
• Mirrors packaged skills into both .claude/skills/ and .agents/skills/
• Covers option generation, architectural documentation, quality attributes, and risk analysis

Install

Option A: Install globally

git clone https://github.com/45ck/software-architecture-skills.git
cd software-architecture-skills
bash install.sh

This installs every packaged skill into both:

• ~/.claude/skills/
• ~/.agents/skills/

Option B: Copy into a project

cp -R .claude /path/to/your-project/
cp -R .agents /path/to/your-project/

Uninstall

bash uninstall.sh

Usage

/architecture-option-generator event-driven analytics platform
/layered-architecture-designer SaaS back office
/component-boundary-reviewer billing and subscriptions module
/quality-attribute-scenario-writer uptime and latency goals for a public API
/tradeoff-analysis-writer monolith vs services for a growing product
/adr-writer choose PostgreSQL over MongoDB for transactional workflows

Repo structure

skills/                              original source skills
templates/                           reusable templates
examples/                            sample flow material
.claude/skills/<skill>/SKILL.md      packaged skill format
.agents/skills/<skill>/SKILL.md      mirrored packaged skill format
install.sh                           global installer
uninstall.sh                         global uninstaller
LICENSE                              MIT

Related workflow agents

• software-architect - Own architecture options, ADRs, and tradeoff analysis
• software-architect-beads - Track architecture risks and follow-up actions
• system-modeler - Support modelling that feeds architecture decisions

Related skill packs

• business-analysis-skills - Business analysis techniques, workflows, and quality checks
• marketing-product-skills - Product strategy, growth, positioning, launch, SEO, and pricing skills
• hci-review-skill - Structured HCI and UX review skills
• fagan-inspection-skill - Formal inspection and defect-review skills
• data-structures-algorithmic-reasoning-skills - Data structure selection and algorithmic reasoning skills
• oop-code-structure-skills - Object-oriented design and class-structure review skills
• web-engineering-skills - Web request handling, MVC, validation, routing, and navigation skills
• backend-persistence-skills - Persistence, schema, ORM, query, and migration skills
• enterprise-architecture-integration-skills - Enterprise topology, integration, messaging, and cloud skills
• uml-analysis-modelling-skills - UML analysis and modelling skills
• verification-test-design-skills - Verification, coverage, decision-table, and oracle design skills
• automation-testing-skills - Unit, integration, API, UI, regression, and flaky-test skills
• non-functional-testing-skills - Performance, resilience, scalability, soak, stress, and NFR testing skills
• software-quality-skills - Quality models, technical debt, maintainability, and reliability skills
• code-review-inspection-skills - Formal inspection, checklist-driven review, metrics, and rework planning skills
• refactoring-code-smells-skills - Refactoring, anti-pattern, duplication, and code smell review skills
• design-for-testability-skills - Seams, DI, determinism, hidden I/O, and testability design skills
• security-engineering-skills - Threat modeling, boundaries, least privilege, and secure defaults skills
• authentication-cryptography-skills - Authentication, token, certificate, revocation, and MITM review skills
• pentest-security-testing-skills - Pentest scoping, recon, attack-surface mapping, OWASP, and finding-report skills
• llm-agent-security-skills - Prompt injection, agent permissions, retrieval trust, memory, and tool-chain security skills
• deployment-release-skills - Deployment strategy, go-live readiness, rollback, and release operations skills
• maintenance-evolution-skills - Maintenance triage, change impact, migration, regression, and deprecation skills
• project-management-skills - Project chartering, scope, WBS, milestones, estimation, and closure skills
• agile-delivery-skills - Backlog shaping, sprint goals, retrospectives, blockers, and delivery discipline skills
• cloud-platform-operations-skills - Cloud placement, rollout readiness, patching, migration waves, and lifecycle operations skills
• documentation-evidence-skills - Specifications, rationale, reports, traceability, plans, and evidence quality skills
• research-literature-review-skills - Search strategy, screening, synthesis, evidence strength, and gap-analysis skills

Related doctrine and utility repos

• frontier-agent-playbook - Shared doctrine for frontier-capability prior, agentic thinking, anti-fallback checks, and LLM-first architecture
• repo-branding-skill - Repository branding, banner generation, and README/social preview asset creation

License

MIT