Skip to content

Latest commit

 

History

History
135 lines (88 loc) · 3.4 KB

File metadata and controls

135 lines (88 loc) · 3.4 KB

Product Direction

One-Line Promise

Agent Propeller helps non-developers become effective and safe leaders of agent programs like Codex, Antigravity, and Claude Code.

Problem

Non-developers often struggle with agent tools for the same reasons:

  • they ask in high-context shorthand
  • they under-specify the deliverable
  • they do not know what follow-up questions matter
  • they cannot easily judge the safety of proposed shell commands
  • they feel pressure to approve actions they do not fully understand

The default response is often:

Learn to prompt better.

That is not enough.

The better response is:

  • coach the user through clearer task framing
  • make the agent ask reverse questions before execution
  • explain proposed bash commands in plain language
  • isolate risky work and create backups before changes
  • help the user build operator judgment over repeated sessions

Target User

Primary target:

  • non-developer heavy users of agent programs

Examples:

  • founder using multiple agents for planning, docs, and execution help
  • operator using agents for research, memos, and workflow setup
  • student using agents for structuring work and learning faster
  • writer or researcher using agents for synthesis and drafting

User Jobs

Users want agent tools to:

  • understand what they mean even when they are messy
  • ask only the most helpful clarifying questions
  • explain what a proposed bash command actually does
  • make it obvious when something is risky or irreversible
  • work inside a safer operating pattern with checkpoints and backups
  • help them feel like they are directing the agent, not chasing it

Best Product Shape

Agent Propeller should feel like a combination of:

  • request clarification coach
  • safe execution interpreter
  • backup and isolation playbook
  • operator training journal

It should not feel like:

  • a benchmark suite for agent engineers
  • a dashboard-first ops product
  • an opaque safety layer the user cannot inspect

Design Principles

  • clarity before execution
  • ask fewer but better reverse questions
  • explain before asking for approval
  • isolate before modifying
  • back up before risk
  • keep the user in control of what gets approved
  • lightweight before comprehensive

Core Loops

1. Request Clarification Loop

User gives a messy request.

System helps sharpen it by:

  • restating the request in execution-ready language
  • identifying ambiguity
  • asking 1-3 focused reverse questions
  • producing a provisional brief

Result:

  • better execution starts

2. Safe Execution Loop

Agent proposes terminal or file actions.

System helps the user by:

  • translating each bash command into plain language
  • calling out why the command is needed
  • marking likely risk level
  • routing work into an isolated workspace when possible
  • creating a backup or checkpoint before risky changes

Result:

  • more informed approvals and fewer avoidable mistakes

3. Operator Learning Loop

User works with agents repeatedly.

System notices:

  • how much explanation they want
  • what risk level triggers hesitation
  • which agents they use for what jobs
  • what kinds of clarifying questions help most

Result:

  • stronger operator confidence and more personalized guidance

Key UX Promise

The user should feel:

  • The agent helps me think before it acts.
  • I understand what I am approving.
  • I can use multiple agent tools without feeling reckless.
  • I am getting better at leading these systems.