ProjectSpecs is a lightweight, AI-native project specification layer that turns enterprise requirements and architecture artifacts into structured, traceable project specs consumable by humans and AI assistants.

Why ProjectSpecs

• Reduce copy/paste drift across enterprise artifacts and AI tools
• Keep a single, local source of truth for requirements and architecture
• Preserve traceability from requirements to delivery and verification
• Enable AI-assisted workflows without losing human-readable context

Quick Start

Requirements:

• Node.js 20+
• pnpm 9+

Install and build:

pnpm install
pnpm build

Initialize a project:

pnpm projectspec -- init

Development

This repo uses pnpm workspaces and Turbo.

Setup

pnpm install

Common tasks

pnpm lint
pnpm test
pnpm build

Documentation

• Project overview: docs/overview.md
• Project manifest: docs/manifest.md
• CLI usage: packages/cli/README.md

Status

Early foundation phase. Expect breaking changes while core workflows and tooling stabilize.

Repository Layout

.
├─ docs/
├─ openspec/
├─ packages/
│  └─ cli/
└─ projectspec/

Contributing

We welcome contributions. Please read CONTRIBUTING before opening a PR.