system-design-gate

Validates projects against mechanical system-design and security rules before git push.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/timikalo7/Execute --skill system-design-gate-timikalo7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design-gate
Source: https://github.com/timikalo7/Execute/tree/main/.claude/skills/system-design-gate
Command: npx skills add https://github.com/timikalo7/Execute --skill system-design-gate-timikalo7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Mechanical engineering rules (lockfiles committed, no secrets in git, documented env vars, parameterized SQL) are easy to forget, and a rule that isn't runnable gets skipped. This gate turns the checkable slice of system-design and security law into a script that blocks a push on violations. ## Core Features & Use Cases - Blocking checks: Fails with exit code 1 on missing lockfiles, tracked .env files, undocumented process.env variables, TODO(keys) without SETUP-KEYS.md, missing PROJECT-LOG.md, string-interpolated SQL, and auth tokens stored in localStorage. - Non-blocking warnings: Flags server/API code with no rate-limit reference and server-side fetch calls without a timeout or AbortSignal. - E-commerce enforcement: Detects payment dependencies or cart/checkout routes and requires evidence the e-commerce guideline was applied. - Use Case: Before pushing a Next.js project, run the gate to catch a committed .env file and a SQL query built with template literals, fixing them before they reach the remote. ## Quick Start Run the system-design gate on my project directory and fix any blocking findings before I push.

Frequently Asked Questions about system-design-gate

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

FAQPage Schema
How do I run the system-design gate on my project?

Run node .claude/skills/system-design-gate/check.mjs --dir projects/<name> from the repo root. The script exits with code 1 if any blocking rule fails, and it runs automatically via the pre-push hook for every project a push touches.

What checks fail a git push in this gate?

Blocking failures include a missing lockfile, a tracked .env file, undocumented non-public process.env variables, TODO(keys) markers without SETUP-KEYS.md, a missing PROJECT-LOG.md, string-interpolated SQL queries, and auth tokens stored in localStorage.

Does this gate replace a security code review?

No. It only covers mechanically-checkable rules and cannot detect authorization gaps, IDOR, multi-tenant leaks, race conditions, or business-logic abuse. Projects with backends, auth, databases, or payments still require the security-reviewer agent before shipping.

Why does the gate warn about fetch calls without a timeout?

Server-side fetch calls without an AbortSignal or timeout can hang indefinitely when a dependency stalls. The gate reports these as non-blocking warnings mapped to the rule that every remote call needs a timeout.

Can I skip the PROJECT-LOG.md requirement?

Yes, pass the --no-log-required flag, or run the gate outside a projects/ directory. The log requirement only applies to paths under projects/ because PROJECT-LOG.md is the substrate the learning loop reads.