spec-challenger

Audit technical decision documents for blind spots, operational risks, and alternatives.

3|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Zoomma1/get-your-life-together --skill spec-challenger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-challenger
Source: https://github.com/Zoomma1/get-your-life-together/tree/main/99%20-%20Claude%20Code/Skills/spec-challenger
Command: npx skills add https://github.com/Zoomma1/get-your-life-together --skill spec-challenger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures your architectural or technical decision documents are thoroughly audited, reducing the risk of costly mistakes before they are implemented.

Core Features & Use Cases

  • Critical Audit: Provides a structured audit of technical decisions.
  • Jaded Engineer: Challenges decisions with solid arguments and alternative solutions.
  • Use Case: Use /spec-challenger [file path] to audit a specs or architectural decision document for blind spots, operational risks, and alternatives before implementation.

Quick Start

Use the spec-challenger skill to audit the document located at 'docs/architecture.md'.

Frequently Asked Questions about spec-challenger

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

FAQPage Schema
How do I audit architecture and technical decision documents for blind spots?

You audit technical decision documents by simulating a jaded staff engineer's perspective to identify blind spots, operational risks, and alternatives. This critical review process stress-tests specs and architecture decisions before implementation.

What is the best way to stress-test technical decisions before implementation?

Stress-test technical decisions by performing a structured critical audit on your spec or architecture documents. This process challenges choices with solid arguments and surfaces alternative solutions to reduce costly implementation mistakes.

How does a jaded engineer simulation validate tech decisions?

A jaded engineer simulation validates tech decisions by thoroughly reading your documents and considering various risk scenarios. It constructs solid arguments against your choices and proposes alternative solutions to expose operational risks.

Can I use this critical audit on architecture decision records (ADRs)?

Yes, you can use this critical audit on architecture decision records (ADRs). The process explicitly applies to specs, architecture documents, ADRs, and technical decision documents to identify operational risks and alternatives.

What are the limitations of automated risk assessment for specs?

Automated risk assessment for specs requires thorough reading of documents and consideration of various risk scenarios. It should not replace human judgment but rather complement it by challenging decisions with constructive, structured arguments.