maintain-project-specs

Maintain canonical requirements and design documents through validated paired publication.

7|5|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/nebius/nebius-ps-services --skill maintain-project-specs-nebius
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintain-project-specs
Source: https://github.com/nebius/nebius-ps-services/tree/main/skills/maintain-project-specs
Command: npx skills add https://github.com/nebius/nebius-ps-services --skill maintain-project-specs-nebius

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Project requirements and design documents drift out of sync with accepted user intent and delivered implementation, leaving teams without a trustworthy contract. This Skill keeps canonical docs/requirements.md and docs/design.md current by classifying every direct user prompt, reconciling durable intent before implementation, and recording verified delivery evidence afterward. ## Core Features & Use Cases - Statement-level intent classification: Every direct root-user prompt is classified as durable requirement intent or non-lifecycle, so unrelated requests leave specs untouched. - Atomic paired publication: Requirements and design are published together through a compare-and-set transaction bound to Git HEAD and both prior file digests, with rollback on partial failure. - Schema v2 validation and migration: Independent requirement status, design readiness, and delivery axes are validated, and legacy Task Implementer or v1 documents migrate with journaled backups and recovery. - Use Case: A user asks an agent to add a new CLI behavior. The skill records the durable requirement and a ready design before coding, then after tests pass advances delivery to verified and the requirement to satisfied. ## Quick Start Ask the agent to use maintain-project-specs to reconcile the selected project's requirements and design documents with the latest accepted intent and implementation evidence.

Frequently Asked Questions about maintain-project-specs

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

FAQPage Schema
How do I keep requirements and design docs in sync with code changes?

Use the maintain-project-specs workflow: classify each direct user prompt for durable intent, reconcile requirements and a ready design before implementation, then record implementation and verification evidence afterward. Publication writes both documents atomically with compare-and-set checks.

What commands does the project specs helper script support?

The script exposes inspect, validate, publish, migrate, and recover, all taking --project-root. Inspect and validate are advisory; publish is the normal write path requiring candidate files, expected Git HEAD, both prior digests, and an operation ID.

Can hooks block tools or stop an agent session?

No. Hooks are advisory only: SessionStart observes document markers and UserPromptSubmit stages metadata-only intake. There are no PreToolUse, PostToolUse, or Stop registrations, and failures degrade to neutral advisory behavior.

How do I migrate legacy Task Implementer specs to schema v2?

Run the migrate command with the project root. It preserves stable TI-* IDs and human-owned bytes, writes journaled backups before changing files, and validates the converted pair; recover can roll back using the recorded digests.

When should specs not be updated?

Skip updates for explanations, brainstorming, status checks, formatting-only edits, one-off operations, or fixes that restore already-documented behavior. Only durable product intent or proven delivery evidence changes the canonical documents.