reviewing-typescript-architecture

Review Architectural Decision Records against testing principles and identify violations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that Architectural Decision Records (ADRs) adhere to established testing principles, preventing common architectural pitfalls and promoting robust design.

Core Features & Use Cases

  • ADR Review: Analyzes ADRs against a defined set of testing principles.
  • Violation Identification: Pinpoints specific lines and principles that are violated.
  • Corrective Guidance: Provides concrete examples of how to refactor the architecture to comply.
  • Use Case: When reviewing a new feature's ADR, use this Skill to ensure it includes a clear testing strategy, avoids unnecessary mocking, and aligns with higher-level architectural decisions.

Quick Start

Review the attached ADR document for adherence to testing principles.

Frequently Asked Questions about reviewing-typescript-architecture

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

FAQPage Schema
How do I review an ADR for testing principles in TypeScript architecture?

To review an ADR for testing principles in TypeScript architecture, submit the document for analysis. It checks for mocking prohibition, dependency injection, and testing strategy inclusion, returning specific feedback on any violations found.

What testing principles should an Architectural Decision Record include?

An Architectural Decision Record should include testing principles such as mocking prohibition, dependency injection, and a defined testing strategy with level assignments. It must align with higher-level architectural decisions to ensure robust design.

How do I identify testing principle violations in ADRs?

To identify testing principle violations in ADRs, analyze the document against established rules. The review pinpoints specific lines where principles are violated, references the exact principles broken, and demonstrates correct architectural approaches with code examples.

Does this ADR review process support TypeScript dependency injection patterns?

Yes, the ADR review process supports TypeScript dependency injection patterns. It analyzes architectural decision records specifically for adherence to dependency injection principles and provides corrective guidance with code examples when violations are identified.

What is the best way to enforce mocking prohibition in architectural decisions?

The best way to enforce mocking prohibition in architectural decisions is to review ADRs against defined testing principles. This process identifies where unnecessary mocking is proposed, references the violated principle, and demonstrates refactored architectural approaches with code examples.

Why does my ADR need a testing strategy with level assignments?

Your ADR needs a testing strategy with level assignments because it ensures adherence to established testing principles. Reviewing for this inclusion prevents common architectural pitfalls, promotes robust TypeScript design, and aligns decisions with higher-level architecture.