plan__maintain-work-spec

Creates or updates canonical work-spec.md files synchronized with eval-plan.md documents.

1|1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/erikhazzard/vasir --skill plan-maintain-work-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan__maintain-work-spec
Source: https://github.com/erikhazzard/vasir/tree/main/.agents/skills/plan__maintain-work-spec
Command: npx skills add https://github.com/erikhazzard/vasir --skill plan-maintain-work-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates and maintains a canonical Work Spec artifact that ties product, UX, engineering scope, milestones, and decision state into a single durable document. It enforces a stable structure, explicit truth labeling, and a synchronized relationship with eval plans and related docs.

Core Features & Use Cases

  • Creates or updates the canonical work-spec.md file at docs/work/<semantic-folders>/<feature-slug>/work-spec.md as the authoritative source of truth.
  • Synchronizes with corresponding eval-plan.md when present and maintains linked gates and proof contracts.
  • Used whenever scoping new work, refining milestones, or consolidating context across teams to reduce ambiguity and drift.

Quick Start

Create or update a Work Spec by running the maintain-work-spec skill in the target repository and editing the resulting docs/work/<semantic-folders>/<feature-slug>/work-spec.md file.

Frequently Asked Questions about plan__maintain-work-spec

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

FAQPage Schema
How do I create a canonical work specification document for a new feature?

To create a canonical work specification, ingest the current work context to generate a durable work-spec.md file. This document serves as the authoritative contract, tying product, UX, and engineering scope into a single source of truth.

What is a Work Spec and when do I need to maintain one?

A Work Spec is a durable contract that consolidates product scope, milestones, and decision state into a single document. You need to maintain it when defining new work, updating milestones, or aligning related docs to reduce ambiguity and drift.

How do I keep my eval-plan synchronized with my work spec milestones?

To keep your eval-plan synchronized, update the work-spec.md file and the Skill will automatically maintain linked gates and proof contracts with the corresponding eval-plan.md. This ensures both artifacts stay aligned without manual cross-referencing.

What is the best way to structure project documentation to prevent context drift across teams?

The best way to prevent context drift is using a canonical Work Spec that enforces stable structure, explicit truth labeling, and synchronized relationships with related docs. This ties engineering scope and decision state into one durable document.

Can I use this work spec approach to consolidate existing scattered project documentation?

Yes, you can use this approach to consolidate scattered documentation. The Skill ingests current work context and crafts a canonical Work Spec, enforcing stable structure and a change log to synchronize linked artifacts and reduce ambiguity.

Why does my work spec need explicit truth labeling and a change log?

Your work spec needs explicit truth labeling and a change log to enforce stable structure and maintain a compact knowledge base. These elements guide last-updated tracking and action items, ensuring the document remains a durable, authoritative contract.