HK-hub/AgentSkills / ax-audit
ax-audit
VerifiedAudits agentic applications for architecture and trust: tool parity, tool granularity, context injection, completion signals, approval gates, confidence cues, escape hatches, intent handshakes, memory visibility, and adaptive canvases. Produces a ship-readiness verdict plus an AX Relationship Summary. Use when reviewing agentic feature PRs or asking "is this agent-native", "AX review", "critique this AI feature", "does this earn user trust", or "audit this for AX". For traditional frontend UX use ui-audit.
rules-ax/_sections.md
View on GitHub# Sections: Agentic Experience (Layer 2)
This file defines the 4 categories of agentic experience audit rules. Each rule file uses one of these category prefixes.
---
## 1. Trust & Transparency (trust)
**Default tier:** mostly fix-this-sprint; release-blocker for missing escalation paths
**Why critical:** Users won't trust an agent, even when it's right, unless they can see why it decided what it did. Confident wrong answers without uncertainty markers or escalation paths cause permanent trust damage that future accuracy can't recover.
## 2. Control & Recovery (control)
**Default tier:** release-blocker for missing escape hatches; fix-this-sprint for over-conversational
**Why critical:** Autonomy without exit is coercion. Every agent action needs a visible path to undo, revise, or override. The approval model must match the stakes and reversibility of the action. Chat-only interfaces for button-worthy actions waste user time and patience.
## 3. Context & Memory (context)
**Default tier:** mostly fix-this-sprint to backlog
**Why critical:** Agents that don't show what they remember feel opaque. Agents that don't use available context feel stupid. Interfaces that don't reshape with task progression feel static. All three erode the relationship depth that makes agent products defensible.
## 4. Agent Communication (comm)
**Default tier:** release-blocker for silent execution; fix-this-sprint for missing handshake; backlog for missing drafts
**Why critical:** Silent agents feel broken. The communication contract between agent and user (progress signals, intent confirmation, and generative momentum) is the difference between a tool that works and a black box.
---
## Rule index
```
trust-no-confidence-cues trust-no-uncertainty-markers trust-no-escalation-path
control-no-escape-hatch control-no-approval-gate control-over-conversational
context-memory-not-visible context-no-adaptive-canvas context-under-contextual
comm-no-intent-handshake comm-no-progress-signal comm-no-generative-momentum
```
Total: 12 rules.
---
## Cross-rule interactions
These pairings often co-fire on the same surface:
- **no-confidence-cues + no-uncertainty-markers**, Both address "why should I trust this." Different targets: rationale vs. hedging.
- **no-escape-hatch + no-approval-gate**: For autonomous actions, both fire. Approval gate may partially satisfy escape hatch.
- **no-progress-signal + no-intent-handshake**: Long-running tasks that didn't confirm scope AND show no progress are doubly opaque.
- **memory-not-visible + under-contextual**, Complementary: one says the agent knows things the user can't see; the other says it doesn't know things it should.
- **over-conversational + no-generative-momentum**, Paradoxical pairing: forcing chat where buttons would do, while failing to offer drafts where blanks would benefit.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |