# Prompt Refinement

> Convert vague requests into compact TCRO prompts with phase-specific constraints. Used by research, specify, plan, and work workflows.

- Skill: `v1truv1us-ai-eng-system/prompt-refinement` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add v1truv1us-ai-eng-system/prompt-refinement`
- Raw SKILL.md: https://api.skillmd.com/api/skills/v1truv1us-ai-eng-system/prompt-refinement/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: v1truv1us (https://skillmd.com/u/v1truv1us-ai-eng-system)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/v1truv1us-ai-eng-system/prompt-refinement

---


Default output: return the refined prompt only. Ask at most one blocking question.

# Prompt refinement

Convert the request into TCRO:

- **Task**: observable objective.
- **Context**: relevant repository, user, or system facts.
- **Requirements**: constraints, acceptance criteria, and non-goals.
- **Output**: artifact, schema, destination, and length.

Do not add personas, stakes, challenge language, generic reasoning instructions, or confidence scores.

## Phase requirements

### Research

Specify the question, scope, source types, evidence standard, and desired depth. Default output is a short finding summary plus citations or a named report file.

### Specify

Define users, behavior, interfaces, edge cases, compatibility, and acceptance criteria. Exclude implementation choices unless they are constraints.

### Plan

Define the source spec, implementation boundaries, dependency order, verification commands, and completion criteria.

### Work

Define the exact change, allowed scope, required tests, verification commands, and handoff output. Include a non-goal for likely scope creep.

## Refinement rules

1. Preserve explicit user wording where it carries intent.
2. Infer reversible details from repository context.
3. Ask only when a missing answer changes architecture, security, compatibility, or irreversible behavior.
4. Replace vague terms with measurable checks.
5. Remove duplicated context and optional prose.

## Template

```text
Task: <observable objective>
Context: <required facts>
Requirements:
- <constraint or acceptance criterion>
- Non-goal: <excluded scope>
Output: <artifact/schema/length>
Verify: <checks>
```