Skip to content

Conversation

@eberrigan
Copy link
Collaborator

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

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

🤖 Generated with Claude Code

eberrigan and others added 2 commits December 11, 2025 14:15
Set up OpenSpec framework to enable spec-driven development for the
SLEAP support agent system. This establishes the foundation for
creating, reviewing, and implementing proposals using TDD.

- Add openspec/project.md: Complete project overview including SLEAP
  ecosystem (sleap, sleap-nn, sleap-io), tech stack, conventions,
  common support issues
- Add openspec/constitution.md: Team principles, code standards,
  support philosophy
- Add openspec/AGENTS.md: Instructions for AI assistants on when and
  how to use OpenSpec workflow

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add OpenSpec-generated slash commands for Claude Code and root-level
agent instruction files for broader compatibility.

- Add .claude/commands/openspec/: Slash commands for /openspec:proposal,
  /openspec:apply, /openspec:archive
- Add AGENTS.md and CLAUDE.md: Root-level agent instructions that
  redirect to openspec/AGENTS.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants