fission-ai__openspec/openspec/changes/update-agent-file-name/specs/openspec-conventions/spec.md

MODIFIED Requirements

Requirement: Project Structure

An OpenSpec project SHALL maintain a consistent directory structure for specifications and changes.

Scenario: Initializing project structure

• WHEN an OpenSpec project is initialized
• THEN it SHALL have this structure:

openspec/
├── project.md              # Project-specific context
├── AGENTS.md               # AI assistant instructions
├── specs/                  # Current deployed capabilities
│   └── [capability]/       # Single, focused capability
│       ├── spec.md         # WHAT and WHY
│       └── design.md       # HOW (optional, for established patterns)
└── changes/                # Proposed changes
    ├── [change-name]/      # Descriptive change identifier
    │   ├── proposal.md     # Why, what, and impact
    │   ├── tasks.md        # Implementation checklist
    │   ├── design.md       # Technical decisions (optional)
    │   └── specs/          # Complete future state
    │       └── [capability]/
    │           └── spec.md # Clean markdown (no diff syntax)
    └── archive/            # Completed changes
        └── YYYY-MM-DD-[name]/