skills.rest
UditAkhourii
UditAkhouriiCOMMUNITY
Explore all skills by this author →
Website𝕏@akhouriuditGitHub

Branerail

Guides architectural design, resilience analysis, and code review for AI-generated systems.

50|4|Updated Apr 27, 2026
Search Tags:#architecture#code review#system design#claude code#resilience#design tokens#observability
One-click install
npx skills add https://github.com/UditAkhourii/branerail --skill branerail-uditakhourii
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Branerail
Source: https://github.com/UditAkhourii/branerail
Command: npx skills add https://github.com/UditAkhourii/branerail --skill branerail-uditakhourii

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? AI code generators produce syntactically correct code that is often architecturally unsound, with unclear state ownership, missing observability, and hidden failure modes. This Skill enforces design-first thinking so systems are specified, auditable, and resilient before and after code generation. ## Core Features & Use Cases - Three Pillars Framework: Audits any system for state ownership, feedback/observability, and blast radius using structured checklists. - Spec and Design Templates: Provides an architectural spec template and a Google DESIGN.md template for visual design tokens with WCAG validation. - Code Review Checklist: Audits AI-generated code across spec compliance, error handling, concurrency, security, and performance. - Automation Scripts: Includes branerail-audit to verify project structure (CLAUDE.md, /specs, DESIGN.md) and branerail-chaos to generate chaos-test prompts from spec failure modes. - Use Case: Before building a checkout service, write a spec from the template, prompt Claude Code against it, then run the review checklist to catch missing circuit breakers and untested failure modes. ## Quick Start Ask the agent to review your system design or AI-generated code against the Three Pillars of state, feedback, and blast radius.

Frequently Asked Questions about Branerail

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

FAQPage Schema
How do I review AI-generated code for architectural soundness?▼

Run the code review checklist covering spec compliance, state ownership, error handling, observability, dependencies, testing, security, and performance. Start with the three quick questions: where state lives, where feedback lives, and what breaks if the component is deleted.

How do I write an architectural spec before coding?▼

Copy the spec template from references/spec_template.md and fill in inputs, outputs, state ownership, failure modes, observability, and dependencies. Then reference the spec file directly in your Claude Code prompt so generated code satisfies its requirements.

What is DESIGN.md and how does it work with Claude Code?▼

DESIGN.md is a format combining YAML design tokens with markdown rationale so AI agents generate on-brand UI. Validate it with npx @google/design.md lint and export tokens to Tailwind or W3C DTCG formats.

Does Branerail include automation tools?▼

Yes, it ships two Node.js CLI scripts: branerail-audit checks your project for CLAUDE.md, a specs directory, and DESIGN.md, while branerail-chaos parses a spec file and generates chaos-test prompts to verify resilience logic.

When should I not rely only on AI-generated code?▼

Never trust generated code without audit, because LLMs are probabilistic and can introduce subtle auth bypasses, race conditions, and silent failures. Manually review against the checklist and periodically reimplement critical code from memory.

Related Skills

Explore More Software Engineering Skills→
0xrafasec0xrafasec
9

architecture

Design and document system architecture with components, data flow, and deployment strategies.

Community
Advanced
pluginagentmarketplacepluginagentmarketplace
5

monitoring-observability

Implement Prometheus metrics, Grafana dashboards, structured logging, and alerting for data pipelines.

Community
Advanced
Axel-DaMageAxel-DaMage
2

chaos-engineer

Design chaos experiments and automate failure injection for distributed systems.

Community
Advanced
teaglebuiltteaglebuilt

architect

Design, analyze, and document software architecture with C4 model diagrams and ADRs.

Community
Advanced