1. SPEC (Specification)
   └── Define feature specifications → openspec/specs/feature-name.md

2. PROPOSE (Proposal)
   └── Create change proposal → openspec/changes/change-name.md

3. IMPLEMENT (Implementation)
   └── Implement code according to specifications

4. VERIFY (Verification)
   └── Confirm implementation meets specifications

5. ARCHIVE (Archiving)
   └── Archive changes after completion → dash spec archive . change-name

project/
└── openspec/
    ├── specs/           # Feature specifications
    │   ├── auth.md
    │   └── dashboard.md
    ├── changes/         # Active change proposals
    │   └── add-login-feature.md
    └── archive/         # Archived changes
        └── 2026-01-setup-project.md

---
title: User Authentication
status: active
created: 2026-01-17
---

# User Authentication

## Overview
Implement user login/logout functionality.

## Functional Requirements
1. Support Email + Password login
2. Support Google OAuth
3. Remember login status

## API Specifications
- POST /api/auth/login
- POST /api/auth/logout
- GET /api/auth/me

## Related Changes
- [[add-login-feature]]

---
title: Add Login Feature
type: feature
status: in-progress
spec: auth
created: 2026-01-17
---

# Add Login Feature

## Change Content
Implement Email + Password login functionality.

## Scope of Impact
- `src/auth/` directory
- `src/api/routes/auth.ts`

## Test Plan
1. Unit Tests: Login logic
2. Integration Tests: API endpoints
3. E2E Tests: Login flow

## Checklist
- [ ] Implement login form
- [ ] Implement API endpoints
- [ ] Write tests
- [ ] Update documentation

# Automatically detect openspec/ and validate
dash validate .

# Check items:
# - Directory structure integrity
# - Specification file format
# - Outdated change reminders

# Show specification health status
dash health .

# Scoring items:
# - Specification coverage rate
# - Change processing rate
# - Format correctness

# Install OpenSpec CLI
npm install -g @fission-ai/openspec@latest

# Verify installation
openspec --version

# Initialize in project
cd your-project
dash spec init .

npm install -g @fission-ai/openspec@latest

---
title: Specification Title
status: active
---

# Content...