Branerail

Branerail Skill: CTO-Level Architectural Agent

A production-grade skill for Claude Code that enforces CTO-level thinking in AI-native development. This skill moves beyond code generation to **architectural design, resilience patterns, and systems thinking**.

---

What This Skill Does

**Branerail** is triggered whenever you're building, reviewing, or thinking about complex systems. It:

1. Forces design-first thinking before code generation
2. Audits AI-generated code for architectural soundness
3. Integrates Google's design.md standard for consistent visual design systems
4. Guides resilience patterns (retry, circuit breaker, bulkhead isolation)
5. Clarifies state ownership, observability, and dependencies
6. Provides actionable checklists for code review and deployment
7. Automates architectural audits via built-in CLI tools

---

🚀 Installation

Install the Branerail skill globally via NPM:

npm install -g @uditakhouri/branerail

Or add it to your project:

npm install --save-dev @uditakhouri/branerail

---

---

🎯 Trigger Keywords

Use this skill whenever you encounter: *architecture, scale, resilience, state ownership, blast radius, observability, distributed systems, design.md, code review.*

⚡ Superpowers (Automation Scripts)

This skill now includes **active automation** to enforce architectural rigor. Once installed, you can use these tools to audit your system:

• branerail-audit: Scans your project root to ensure you have the required CLAUDE.md, /specs, and DESIGN.md in place.
• branerail-chaos: Parses your architectural specs and generates testable "Chaos Prompts" to verify if your resilience logic actually works.
• DESIGN.md Integration: Uses Google's standard for visual tokens; compatible with npx @google/design.md.

---

Core Philosophy: The Three Pillars

Before shipping any system, answer these three questions with certainty:

1. **Where Does Stat