pua-trae

Enforces evidence-based verification and retry discipline for Trae coding agents.

19.6k|1.2k|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/tanweai/pua --skill pua-trae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pua-trae
Source: https://github.com/tanweai/pua/tree/main/.trae/skills/pua-trae
Command: npx skills add https://github.com/tanweai/pua --skill pua-trae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI coding agents often give up too early, declare tasks complete without verification, or blame the environment instead of fixing root causes. This Skill imposes a strict governance workflow on Trae agents so that every claimed completion is backed by build, test, or manual acceptance evidence.

Core Features & Use Cases

  • Separation of Four Powers: Divides action, self-review, scoring, and environment-modification rights so the agent cannot grade its own work or alter tests to fake passing results.
  • Diagnosis-First Protocol: Requires a [PUA-DIAGNOSIS] line stating the problem, evidence, and next action before any code change.
  • De Facto 100% Confidence Loop: Forces hypothesis listing, minimal verifiable actions, local validation runs, and path-switching after two failures before delivery.
  • Use Case: When a Trae agent fails twice on a bug fix and is about to say "cannot be done", this Skill triggers a root-cause analysis, an alternative approach, and a verified delivery report with a SELF-REVIEW section.

Quick Start

Ask the Trae agent to apply the PUA workflow to retry the failing task with diagnosis, verification evidence, and a self-review before declaring completion.

Frequently Asked Questions about pua-trae

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

FAQPage Schema
How do I stop an AI coding agent from giving up too early?

Use a governance skill that forces the agent to list hypotheses, run local verification, and switch to a fundamentally different approach after two failures. This Skill blocks "cannot complete" claims until evidence-backed attempts are exhausted.

How to verify AI agent code changes before accepting them?

Require the agent to output a delivery report containing the commands run, output summaries, and a SELF-REVIEW section listing uncovered risks. Completion status must be backed by build, test, curl, or manual acceptance evidence.

Does this Skill work with Claude Code hooks or subagents?

No, this Trae version is instruction-only and does not use Claude Code hooks, slash commands, or subagents. It encodes the governance rules as mechanical work procedures inside SKILL.md that Trae can load directly.

When should the PUA workflow not be triggered?

Do not trigger it for normal first-attempt coding requests or one-off information queries. It is designed only for explicit PUA requests, repeated failures, user frustration, giving-up behavior, or unverified completion claims.

Can the agent modify tests or CI configuration to make checks pass?

No, the four-powers separation explicitly forbids the acting agent from modifying tests, CI, or scorers to manufacture passing results. Environment changes like file deletion or config edits require prior user confirmation.