spec-driven

Create unified nanospec task directories with shared outputs and alignment files.

1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/xxih/ai-harness-zh --skill spec-driven-xxih
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven
Source: https://github.com/xxih/ai-harness-zh/tree/main/packages/spec-driven/targets/codex/skills/spec-driven
Command: npx skills add https://github.com/xxih/ai-harness-zh --skill spec-driven-xxih

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams juggling multiple skills often lack a common directory structure to store specs, plans, tasks, and alignment notes, leading to fragmented documentation and missed updates.

Core Features & Use Cases

  • Unified Task Container: Creates a nanospec/<date>-<task-name>/ directory with shared outputs/ files and an assets/ folder.
  • Alignment Mechanism: Provides an alignment.md file to capture changes, conflicts, and deviations, ensuring all collaborators stay synchronized.
  • Cross‑Skill Collaboration: Enables any skill to read/write the same spec, plan, and task documents without imposing a rigid workflow, ideal for agile development, product planning, or research projects.

Quick Start

Create a new spec-driven task workspace named “20231101-feature-x” and then start adding spec, plan, and task files as the project progresses.

Frequently Asked Questions about spec-driven

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

FAQPage Schema
How do I set up a shared directory for spec, plan, and task files in multi-skill collaborations?

A spec-driven task workspace creates a centralized nanospec directory to store shared specs, plans, and tasks for multi-skill collaborations. It provides a unified container with outputs and assets folders to prevent fragmented documentation across collaborative agents.

How does alignment tracking work for collaborative agents sharing task documents?

Alignment tracking uses an alignment.md file within the nanospec directory to capture changes, conflicts, and deviations. This ensures all collaborative agents reading and writing shared task documents remain synchronized throughout the project lifecycle.

Can I use a spec-driven task workspace for agile development without a rigid workflow?

Yes, you can use a spec-driven task workspace for agile development without a rigid workflow. The system allows any skill to read and write shared spec, plan, and task documents dynamically, making it ideal for flexible product planning and research projects.

What is the best way to centralize documentation and alignment notes for multi-skill projects?

The best way to centralize documentation is to establish a unified spec-driven task directory. This creates a nanospec container that holds shared output files and tracks alignment, preventing missed updates across collaborating agents.

Do I need specific dependencies to create a nanospec container for cross-skill collaboration?

No specific dependencies are required to create a nanospec container for cross-skill collaboration. The workspace operates independently to establish shared storage for spec, plan, task, and alignment files, allowing any skill to integrate without external tools.