Add OpenSpec framework for spec-driven development

[eberrigan]

Summary

Sets up OpenSpec infrastructure to enable spec-driven development workflow for the SLEAP project, starting with planning for a support agent system.

What's Included

• openspec/project.md: Complete project overview covering:

  • SLEAP ecosystem (sleap, sleap-nn, sleap-io) and repository interactions
  • Technology stack (Python 3.11-3.13, uv, PySide6, pytest, ruff)
  • Development conventions (TDD, Google-style docstrings, git workflow)
  • Common support issues categorized by type

• openspec/constitution.md: Team principles including:

  • User-first design philosophy
  • Reproducibility and accessibility standards
  • Code standards and support philosophy

• openspec/AGENTS.md: Instructions for AI assistants on:

  • When to use OpenSpec (proposals, architecture changes, etc.)
  • Three-stage workflow (create → implement → archive)
  • Spec and proposal formatting
  • SLEAP-specific best practices

Next Steps

This framework will enable us to:

1. Create proposals for the support agent system
2. Review and approve specifications before implementation
3. Follow TDD with clear acceptance criteria
4. Maintain authoritative specs that evolve with the codebase

Test Plan

• [x] OpenSpec CLI installed and verified (openspec --version)
• [x] Directory structure follows OpenSpec conventions
• [x] AGENTS.md provides clear AI assistant instructions
• [x] project.md contains accurate SLEAP ecosystem information

🤖 Generated with Claude Code