本文へ移動
cccskills
無料GitHub で公開

adversarial-gate

JP's signature red-team pass — "how would I break this?" Argue against your own approach before proceeding. Trigger on any high-stakes decision, architecture choice, or before marking work complete.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md3.7 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Adversarial Gate

Coined by Jaroslav Pantsjoha (#HarnessEngineering). The Adversarial Gate is the practice of forcing an agent — or a human — to argue against their own design before proceeding. It pre-empts bad reasoning before bad output exists.

The gate has one question: "How would I break this?"

Answer it honestly. If you cannot name at least two plausible failure modes, you do not understand the system well enough to ship it.

When to use

  • Before finalising any architecture or design decision
  • Before a deployment or release
  • When an agent is about to take an irreversible action
  • When a design looks clean and elegant (danger signal — simple-looking systems hide the hard failure modes)
  • When the team is under time pressure and "just shipping it" feels compelling

Procedure

  1. State the proposal clearly — in one or two sentences, what is the approach being validated?
  2. Run the adversarial pass — argue against it. Ask:
    • What is the single most likely way this fails in production?
    • What happens under load / at scale / with bad input?
    • What is the blast radius if this fails? Is it recoverable?
    • What assumption does this design make that could be wrong?
    • What does the monitoring not cover that would let this fail silently?
  3. Name at least two concrete failure modes — not "something could go wrong" but specific, nameable failures.
  4. Check each failure mode has a mitigation or an accepted risk owner — unmitigated = not shippable.
  5. Document the outcome — pass (risks named and owned) or fail (proceed to redesign). Attach to the ADR or PR.

Outputs

  • Adversarial Gate verdict: PASS / FAIL
  • Named failure modes with mitigations or risk-owner sign-off
  • Optional: a short paragraph appended to the ADR or PR description summarising the gate result

Guardrails

  • One argument is not enough. A single failure mode is the one you were already thinking about. The Adversarial Gate is looking for the one you were not.
  • "We have tests" is not a mitigation. Tests cover known paths. The gate is looking for unknown paths.
  • Time pressure does not suspend the gate. Pressure is when you need it most.
  • The gate is not pessimism. It is the fastest route to confidence — because you have already stress-tested the design yourself.

Anti-rationalization table

Excuse the agent makesCounter
"This is a low-risk change"All production incidents started as low-risk changes. Name the failure mode or accept you cannot assess risk.
"We can fix it after if something breaks"Blast radius unknown = not low risk. Run the gate.
"The tests cover this"Tests cover happy paths. The gate looks for the paths tests miss.
"We've done this before"Prior success is not a guarantee. Conditions change. Run the gate.
"The deadline is today"A production incident will cost more time than the gate. Run the gate.
"I'm confident in this design"Confidence is the leading indicator of skipped gates. Run it anyway.

Reference

This pattern converges with “doubt-driven development” in Addy Osmani's agent-skills. The Adversarial Gate name and “how would I break this?” framing are JP's #HarnessEngineering contribution. The anti-rationalisation table format was adopted after reviewing that MIT-licensed project; this repository does not claim the table format originated here.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Google ADK (Agent Development Kit) orchestration patterns — boundaries, agent composition, and tool seams. Trigger when designing or reviewing multi-agent systems built on ADK. Authoritative source: adk.dev.

日本語の概要は準備中です。原文の説明を表示しています。

jpantsjoha/ai-native-developer-experience122026年10月6日 更新

Read-only SRE checkup of any GCP project: deterministic probes of the edge, Cloud Run services, 7-day error logs, Cloud Scheduler, alert policies and uptime checks, Secret Manager and IAM, the data stores and the machine's own scheduled jobs, audited into one fixed status table (LIVE / WARNING / RED / INCONCLUSIVE) with evidence, findings by severity, what could not be checked, and a single OVERALL line delivered as one notification. Parametrised by a per-project manifest, so the same routine runs on every project. Use when the operator says "cloud checkup", "SRE check", "is everything live", "what's healthy / warning / red", "any errors this week", "audit the infra", "weekly checkup", "set up the weekly checkup", before a deploy or demo, or after an incident. Cloud Run first; App Engine and GKE differ only in the serving probes.

日本語の概要は準備中です。原文の説明を表示しています。

jpantsjoha/ai-native-developer-experience122026年10月6日 更新

Cloud guardrails for any vendor workload — Google Cloud (GCP, Vertex AI, GKE), AWS (IAM, EKS, Bedrock), Azure (Entra ID, Policy, AKS), Alibaba Cloud (RAM, mainland/international residency). Enforces identity least-privilege, mechanical policy, data boundaries, residency, cost caps, network egress and observability, with official-source validation before any claim. Trigger on any cloud infrastructure design, review, Terraform plan, or LLM/agent deployment; the-architect routes here.

日本語の概要は準備中です。原文の説明を表示しています。

jpantsjoha/ai-native-developer-experience122026年10月6日 更新

LLM and cloud cost awareness — model tiering, token budgets, right-sizing, and when a cheaper model suffices. Trigger before finalising any architecture that calls LLMs, before scaling a workload, or when a cost estimate is needed.

日本語の概要は準備中です。原文の説明を表示しています。

jpantsjoha/ai-native-developer-experience122026年10月6日 更新

Decompose an epic into atomic parallelizable tasks, route each to the right skill, and keep the four delivery records straight — issues, STATUS, ROADMAP, CHANGELOG. Use as a meta-router when several skills could apply, and as the baseline for how delivery state is recorded. Trigger at the start of any multi-track epic, when the skill count exceeds ~12, or when the records have drifted from reality.

日本語の概要は準備中です。原文の説明を表示しています。

jpantsjoha/ai-native-developer-experience122026年10月6日 更新

Validate agent output against declared domain rules and ground truth before trusting it downstream. Trigger after any agent produces output that will be used in a decision, stored persistently, or passed to another agent.

日本語の概要は準備中です。原文の説明を表示しています。

jpantsjoha/ai-native-developer-experience122026年10月6日 更新

jpantsjoha のスキルをすべて見る

このスキルの問題を報告する