vision-doc

Maintain the agency vision document with ADR-backed governance and auditable versioning.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/brucebanner010198-commits/DevSecOps-Agency --skill vision-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vision-doc
Source: https://github.com/brucebanner010198-commits/DevSecOps-Agency/tree/main/skills/vision-doc
Command: npx skills add https://github.com/brucebanner010198-commits/DevSecOps-Agency --skill vision-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The vision-doc skill helps the CEO maintain a single source of truth for the agency's mission, active OKRs, and non-goals, ensuring consistent alignment across Chiefs and specialists. It orchestrates bootstrap, pre-dispatch alignment, project-level OKR derivation, and ADR-backed governance with auditable history.

Core Features & Use Cases

  • Bootstrap the workspace vision by creating _vision/VISION.md from the provided skeleton.
  • Pre-dispatch vision slices pull the top 3 relevant OKRs for dispatch and provide alignment context.
  • Update flow with ADR documentation and history entries to capture rationale and governance decisions.
  • Read and write cycles across workspace and project scopes to maintain alignment.

Quick Start

Bootstrap the vision by writing _vision/VISION.md from the skeleton and creating the initial history entry to establish the audit trail.

Frequently Asked Questions about vision-doc

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

FAQPage Schema
How do I maintain a single source of truth for agency OKRs and non-goals across quarters?

To maintain OKRs and non-goals across quarters, establish a vision document with auditable versioning and ADR-backed governance. This ensures consistent alignment across teams by capturing rationale and governance decisions in history entries during quarterly updates.

What is ADR-driven governance for a workspace vision document?

ADR-driven governance for a vision document involves using Architecture Decision Records to capture rationale and governance decisions. It enforces auditable versioning and governance caps for OKRs and non-goals, ensuring alignment during bootstrap and quarterly updates.

How do I bootstrap a workspace vision file from a skeleton?

Bootstrap a workspace vision file by writing the _vision/VISION.md document from a provided skeleton. You then create an initial history entry to establish the audit trail, satisfying requirements for auditable versioning and governance documentation.

Can I derive project-level OKRs from a pre-dispatch vision slice?

Yes, you can derive project-level OKRs from a pre-dispatch vision slice. The process pulls the top 3 relevant OKRs from the workspace vision document to provide alignment context, ensuring read and write cycles maintain consistency across project scopes.

What is the best way to document governance decisions for agency non-goals?

The best way to document governance decisions for non-goals is through an update flow with ADR documentation and history entries. This captures the rationale behind governance caps and changes, maintaining an auditable history across workspace and project scopes.

Do I need auditable versioning for agency vision updates?

Yes, you need auditable versioning for agency vision updates to satisfy governance requirements. It tracks changes to active OKRs and non-goals by capturing rationale and decisions in ADR documentation and history entries across quarterly cycles.