designing-systems
Produces this framework's ADR and system-design artifacts from bundled templates with trade-off analysis. Use when designing a system or component, choosing between architectures, or recording an architecture decision in the planning flow.
How do I install this agent skill?
npx skills add https://github.com/dralgorhythm/claude-agentic-framework --skill designing-systemsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides templates and a workflow for creating architecture decision records (ADR) and system design documents. No security issues were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
3 files scanned · No issues
What does this agent skill do?
Designing Systems
Artifact Selection
- ADR (
./artifacts/adr_[topic].md, template): one decision — a choice among alternatives with rationale and consequences. - System Design Doc (
./artifacts/system_design_[component].md, template): a whole system or component — architecture, data model, API, NFRs, phased plan.
A new system usually needs both: the system design doc for the overall shape, plus an ADR for each decision worth justifying independently (e.g., "why Postgres over DynamoDB").
Workflow
- Requirements: Gather functional and non-functional requirements
- Diagram: Draft a Mermaid diagram showing components and their boundaries
- Data & API: Define the data model, storage strategy, and interface contracts
- Trade-offs: For each major decision, table Option A vs Option B — pros, cons, when to choose
- Risks: Identify single points of failure
- Tech Strategy: Confirm every technology choice matches
.claude/rules/tech-strategy.md— no deviation without explicit instruction - Document: Fill in the matching template and save under
./artifacts/
Design-Validation Loop
- Draft the artifact from the template
- Review with stakeholders
- Build a POC for the riskiest component
- Refine the design from POC findings
- Finalize the artifact
Resources
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/dralgorhythm/claude-agentic-framework/designing-systems">View designing-systems on skillZs</a>