# Vp Guided Focus

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-vdustr-skills-vp-guided-focus`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [VdustR](https://agentstack.voostack.com/s/vdustr)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [VdustR](https://github.com/VdustR)
- **Source:** https://github.com/VdustR/skills/tree/main/skills/vp-guided-focus

## Install

```sh
agentstack add skill-vdustr-skills-vp-guided-focus
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Guided Focus

Structured, one-at-a-time questioning to converge on requirements and decisions before planning or execution. Each question presents options with descriptions, trade-off differences, and a recommended choice with reasoning.

## Workflow

### Phase 0: Activation

- **Manual**: User invokes the skill or asks to clarify first
- **Proactive**: When detecting a complex/ambiguous task, ask: "This task has multiple valid approaches. Want to run guided focus first to align on direction?" — proceed only if user confirms
- **Do NOT trigger proactively for**: single-file edits, bug fixes with clear reproduction steps, tasks with explicit requirements, or when the user has already described a clear plan

### Phase 1: Configuration

Defaults (user can override via invocation arguments or during the session):

| Parameter | Default | Override Example |
|-----------|---------|------------------|
| Question count | 10 | a bare number argument (`5`) or `--questions 5` |
| Min options per question | 3 | `--min-options 4` |

### Phase 2: Questioning Loop

Ask questions **one at a time**. Wait for user response before proceeding.

**Question format** (use bullet list, not table — safe for narrow terminals):

```
### Question [current]/[total] — [Topic]

[Context sentence explaining why this question matters]

**A. [Option name]**
- Description: [what this option means]
- Difference: [how it differs from other options]
- Recommendation: Weak / Moderate / Strong

**B. [Option name]**
- Description: ...
- Difference: ...
- Recommendation: ...

**C. [Option name]**
- Description: ...
- Difference: ...
- Recommendation: ...

**Recommended: [letter] — [option name]**: [1-2 sentence reasoning]
```

Recommendation scale: Weak = viable but not ideal, Moderate = good fit, Strong = best fit for this context.

**Question behavior rules:**

- **Dependency awareness**: Adapt subsequent questions based on previous answers. Skip questions that become irrelevant, add questions that become necessary. When adjusting, tell the user: "Based on your answer to Q[N], I'm [skipping Q about X / adding a question about Y] because [reason]."
- **Progress indicator**: Always show `[current]/[total]` and update total if it changes
- **Dynamic adjustment**: May increase or decrease question count based on task complexity, but never exceed 15 questions total. Always inform the user: "I'm [adding/reducing] questions because [reason]. New total: [N]."

**User response flexibility:**

- Select an option (A/B/C)
- Combine options (A+B) — if combined options conflict, explain the conflict and ask the user to choose one or describe a reconciliation
- Provide a free-form answer
- Ask a counter-question for clarification
- Skip and defer: "skip" or "later" — mark as deferred, addressed in Phase 3
- Express confidence level: "B, but not sure" → marked as uncertain in summary
- End early: "enough", "done", or "wrap up" → immediately proceed to Phase 3

### Phase 3: Deferred Question Resolution

If any questions were skipped/deferred during Phase 2:

1. Present all deferred questions in a single list
2. Ask once: "Want to revisit these, or proceed with them marked as undecided?"
3. If revisit → ask each deferred question with context from other answers
4. If proceed → mark all as undecided in summary

### Phase 4: Summary

Generate a structured summary of all decisions:

```
## Focus Summary

**1. [Topic]**: [Decision] [confidence]
**2. [Topic]**: [Decision] [confidence]
...

### Uncertain Decisions
- **[Topic]**: [Decision marked as uncertain] — may need revisiting during implementation

### Undecided
- **[Topic]**: Deferred — [reason or context]
```

Confidence markers: `[confirmed]` | `[uncertain]` | `[undecided]`

### Phase 5: Review & Handoff

After presenting the summary:

1. Ask: "Want to modify any decisions, or add more questions?"
2. If yes → allow edits or additional questions, regenerate summary
3. If no → ask: "Ready to proceed? Options: **plan** (enter plan mode), **execute** (start directly)"

## Guidelines

- **Don't ask obvious questions** — skip questions where the answer is clearly
  implied by context; never ask about facts detectable from the project
- **Reorder freely** — if a user's answer makes a later question urgent,
  reorder (and tell the user, as with any adjustment)
- **Wrap up early** — if requirements are clear before reaching the question
  count, propose to end and proceed to summary

## Notes

- Questions should progress from high-level (scope, goals, constraints) to specific (implementation details, trade-offs)
- The first 2-3 questions should establish context and scope; detailed questions come after
- If the user's project already has constraints (existing codebase, tech stack), detect and incorporate them rather than asking about known facts

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [VdustR](https://github.com/VdustR)
- **Source:** [VdustR/skills](https://github.com/VdustR/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-vdustr-skills-vp-guided-focus
- Seller: https://agentstack.voostack.com/s/vdustr
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.