architecting-typescript

Generate Architecture Decision Records for TypeScript projects with testing strategies.

1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/outcomeengineering/spx-claude --skill architecting-typescript-outcomeengineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecting-typescript
Source: https://github.com/outcomeengineering/spx-claude/tree/main/plugins/typescript/skills/architecting-typescript
Command: npx skills add https://github.com/outcomeengineering/spx-claude --skill architecting-typescript-outcomeengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you create well-defined Architecture Decision Records (ADRs) for TypeScript projects, ensuring consistency, maintainability, and testability in your software architecture.

Core Features & Use Cases

  • ADR Generation: Write ADRs that document architectural choices, constraints, and trade-offs.
  • Testing Strategy Integration: Mandates the inclusion of a detailed testing strategy within every ADR.
  • Use Case: When deciding on a new data validation library for your TypeScript application, use this Skill to generate an ADR that outlines the choice, its implications, and how it will be tested at different levels.

Quick Start

Use the architecting-typescript skill to write an ADR for using Zod for data validation in a new TypeScript project.

Frequently Asked Questions about architecting-typescript

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

FAQPage Schema
How do I write an Architecture Decision Record for a TypeScript project?

To write an Architecture Decision Record (ADR) for TypeScript, use a structured template that documents architectural choices, constraints, trade-offs, and a comprehensive testing strategy to enforce type safety and maintainability.

What should be included in a TypeScript architecture testing strategy?

A TypeScript architecture testing strategy must detail testing approaches at different levels, ensuring that architectural choices for type safety, clean architecture, and security are validated and testable within the decision record.

When do I need an ADR for software design decisions?

You need an Architecture Decision Record when making architectural choices for product, capability, or feature-level software design, ensuring constraints and trade-offs are documented for consistency and maintainability.

Does this approach support feature-level architectural decisions?

Yes, this approach supports feature-level architectural decisions by generating structured ADRs with specific numbering conventions, ensuring that both high-level constraints and detailed testing strategies are documented.

What is the best way to document data validation choices in TypeScript?

The best way to document data validation choices is to generate an ADR that outlines the selected validation library, its implications for type safety, and how the implementation will be tested across different levels.

Why does clean architecture require decision records in TypeScript?

Clean architecture requires decision records in TypeScript to enforce principles of type safety and testability, ensuring that architectural choices and their constraints are consistently documented and maintained.