Spec v0.1.0 · Open Source

Manage AI like you manage teams

Your management experience — scope control, review processes, decision tracking — encoded as a protocol AI can follow.

Read the Spec → View on GitHub
AI Worker writes code generates lock Human approves AI Reviewer verifies
6 Fields, 6 Questions

Everything a product boundary needs

No routes, no frameworks, no dependencies. Just what the product is.

actors

Who uses it? Define the people, not the code.

entities

What data does it store? The product data model.

features

What can it do? Atomic product capabilities.

stories

How do things interact? The product narrative.

permissions

Who can do what? Role-to-feature matrix.

denied

What must it NOT have? The most important field.

Example

What does it look like?

A complete product boundary in one JSON file. Human-scannable in minutes.

{
  "name": "chat-system",
  "version": "1.0.0",
  "description": "Real-time chat with group conversations and read receipts",
  "author": "kim",

  "actors": ["Admin", "Guest", "Member"],

  "features": ["createGroup", "listConversations", "readReceipts", "sendMessage"],

  "denied": {
    "Reaction": "Keep messaging simple, no emoji reactions",
    "editMessage": "Messages are immutable once sent",
    "voiceCall": "Text-based communication only"
  }
}
Trust Model

Two AIs that don't trust each other

One generates, one verifies. Human makes the final call.

Human

Scans the lock, approves or denies. Never reads code. Reads the lock in minutes.

AI Worker

Writes code, generates the lock from the codebase. Submits for review.

AI Reviewer

Independently verifies code against the lock. Does NOT trust the Worker.

Documentation

Everything you need

Guides for humans and AI. Each document serves a specific role.

Specification

Product Lock Spec

The full specification. File format, fields, validation rules, lifecycle, and conventions.

Read spec →
Guide

Generator Guide

For AI Workers. 10-step process to analyze a codebase and generate a product.lock.json.

Read guide →
Guide

Reviewer Guide

For AI Reviewers. Field-by-field verification process. How to catch violations.

Read guide →
Specification

Plan Spec

Lock defines WHAT. Plan defines HOW. Implementation blueprint format.

Read spec →
Tool

Scoring

Quantify product complexity from a lock. PLS formula validated against 10 open-source products.

Read scoring →
Tool

Worklog

Track changes, decisions, and scope across sessions. Context reconstruction for AI.

Read worklog →