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-arch/comm-no-progress-visibility.md
View on GitHub---
title: Agent actions produce no UI feedback during execution
slug: comm-no-progress-visibility
category: comm
defaultTier: release-blocker
surfaces: agent-chat, agent-tool-execution, agent-dashboard
agent-native-principle: Parity (agent-UI communication)
detection: code-auditable
related: comm-no-completion-signal, comm-no-approval-gate
---
## Agent actions produce no UI feedback during execution
Agent runs 30s showing only a spinner or nothing. User kills the session and restarts. Violates Parity: the UI must communicate what the agent is doing, not just what it finished.
## What goes wrong
Agent makes 12 tool calls over 45s analyzing a codebase; UI shows "Thinking..." the entire time. User assumes it froze, refreshes, agent starts over. With events they'd see "Reading src/index.ts... Found 3 issues."
## Detection
**Surfaces:** agent-chat, agent-tool-execution, agent-dashboard
**Static signals:**
1. Find execution handlers: tool call loops, streaming handlers.
2. Check whether they emit typed events or update UI during execution.
3. Check whether text streams incrementally or batches until completion.
4. Flag handlers that only surface results at the end.
**Concrete commands:**
```bash
rg '(toolCall|tool_use|function_call)' --type=ts -A 10 src/ | rg '(for|while|map)'
rg '(emit|dispatch|onProgress|onToolCall|publish)' --type=ts src/
rg '(stream|onChunk|onToken|onDelta)' --type=ts src/
```
**False-positive guards:**
- Skip files with `// ax-audit-ignore:comm-no-progress-visibility`.
- Skip sub-second operations.
- Skip backend-only code with no UI surface.
- Skip test files and fixtures.
## Fix
```tsx
// before: silent execution
async function handleChat(msg: string) {
const response = await agent.run(msg); // 30s silence
setMessages((prev) => [...prev, response]);
}
// after: progressive event emission
async function handleChat(msg: string) {
for await (const event of agent.stream(msg)) {
switch (event.type) {
case "thinking": setStatus("Reasoning..."); break;
case "toolCall": setStatus(`Running ${event.toolName}...`); break;
case "textDelta": appendToCurrentMessage(event.text); break;
case "done": setStatus("idle"); break;
}
}
}
```
## Default tier and overrides
**Defaults to:** `release-blocker`
| Surface | Tier |
|---|---|
| Agent tool execution | release-blocker |
| Agent chat | release-blocker |
| Agent config | backlog |
| Agent dashboard | fix-this-sprint |
## Examples
**Anti-pattern (fails):** `const result = await agent.run(msg)`: 30s silence, then result.
**Applied (passes):** `for await (const e of agent.stream(msg))`: progressive events.
## Suppression
```tsx
{/* ax-audit-ignore:comm-no-progress-visibility, instant lookup, <500ms */}
<QuickLookupAgent />
```
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 |