vision

Guide structured interviews to create or refine VISION.md documents.

2|Updated May 11, 2026
One-click install
npx skills add https://github.com/lozit/groundrules --skill vision-lozit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vision
Source: https://github.com/lozit/groundrules/tree/main/skills/vision
Command: npx skills add https://github.com/lozit/groundrules --skill vision-lozit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill assists in creating or refining a project's VISION.md file through a structured interview process, addressing the common issues of an incomplete or evolving project vision.

Core Features & Use Cases

  • Interview-Based Vision Development: Guides the creation or enhancement of VISION.md files by prompting users on various aspects like goals, users, constraints, non-goals, and acceptance criteria.
  • Phase-Based Approach: Consists of phases to detect the existing VISION, conduct the interview, perform a self-review, and then write the final vision.
  • On-Demand Activation: Intended for brownfield projects or for enhancing existing thin visions without replacing initial intent capture tools like bootstrap.

Quick Start

To generate or update the VISION.md file, use the command 'run skill vision'.

Frequently Asked Questions about vision

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a VISION.md file for my software project?

To create a VISION.md file, this Skill uses a structured interview process to guide you through defining project goals, users, constraints, and scope, resulting in a complete vision document ready for development planning.

What is the best way to document project vision and scope for developer documentation?

Documenting project vision is best achieved through a phase-based interview that prompts you for goals, user considerations, and non-goals, ensuring your developer documentation captures a robust and structured project scope.

How do I refine an existing project vision that feels incomplete?

To refine an existing project vision, the Skill detects your current VISION.md and conducts an on-demand interview to enhance thin or evolving visions without replacing the initial intent captured during project bootstrap.

Can I use this guided interview for brownfield project management and documentation?

Yes, you can use this guided interview for brownfield project management. It is specifically designed for on-demand activation to enhance existing thin visions or build robust documentation for established projects needing scope delineation.

What steps are involved in generating developer documentation for project visioning?

Generating developer documentation involves a phase-based approach: detecting the existing vision, conducting the interview, performing a self-review of the inputs, and writing the final vision document to delineate project scope.

When should I not use a structured interview for project visioning?

You should avoid using a structured interview for project visioning during a project's initial bootstrap phase, as this Skill is intended for enhancing existing thin visions or brownfield projects rather than replacing initial intent capture tools.