---
description: "Report Setup Feature: File a feature request after a successful setup run"
agdt:
  always: true
---

## User Input

```text
$ARGUMENTS
```

You **MUST** consider the user input before proceeding (if not empty).

## Purpose

Collect developer improvement suggestions after a successful, satisfying setup
run and file a de-duplicated feature request. This agent is **interactive only**
— it requires a TTY and is gated on user satisfaction by the orchestrator.

## Prerequisites

- Setup completed successfully (exit code 0 or 1).
- The orchestrator confirmed TTY availability before invoking this agent.
- The user expressed satisfaction with the setup outcome.

## Actions

### Step 1: Verify TTY Availability

Confirm that an interactive TTY is available. If not, exit gracefully without
prompting (the orchestrator should not have invoked this agent in non-TTY mode).

### Step 2: Prompt for Suggestions

Ask the developer for improvement suggestions based on their setup experience.
Apply an input timeout of `FEATURE_REPORTER_INPUT_TIMEOUT_SECONDS = 120` seconds.

### Step 3: Handle Timeout

If no input is received within 120 seconds:

- Auto-submit the feature request with session-derived context only
- Do not block indefinitely — the timeout ensures the process completes

### Step 4: Compose Feature Request

Build the feature request from:

- Any developer-provided suggestions (if received before timeout)
- Session context (setup duration, environment details, configuration used)

### Step 5: File Feature Request

Set the required structured fields, then file the request:

```bash
agdt-set issue.title "{developer-provided or session-derived feature title}"
agdt-set issue.motivation "{why this improvement is needed, from developer input or session context}"
agdt-set issue.proposed_solution "{developer-provided suggestions or session-derived proposed changes}"
agdt-create-agdt-feature-issue --dedupe
```

The `--dedupe` flag ensures that if an existing open issue matches the feature
signature, the report augments/upvotes rather than creating a duplicate.

## Constraints

- **TTY required** — this agent must only run in interactive terminals.
- **Timeout enforced** — `FEATURE_REPORTER_INPUT_TIMEOUT_SECONDS = 120`.
- **Auto-submit on timeout** — never block indefinitely waiting for input.
- **Satisfaction gated** — only invoked after the user is satisfied with setup.

## Expected Outcome

A de-duplicated feature request is filed (or an existing one augmented) in the
agentic-devtools repository based on the developer's setup experience.

## Next Step

Command is complete.
