Fission-AI/OpenSpec · error · Error

Change must have a Why section

Error message

Change must have a Why section

What it means

Error "Change must have a Why section" thrown in Fission-AI/OpenSpec.

Source

Thrown at src/core/parsers/markdown-parser.ts:61

    return {
      name,
      overview: purpose.trim(),
      requirements,
      metadata: {
        version: '1.0.0',
        format: 'openspec',
      },
    };
  }

  parseChange(name: string): Change {
    const sections = this.parseSections();
    const why = this.findSection(sections, 'Why')?.content || '';
    const whatChanges = this.findSection(sections, 'What Changes')?.content || '';
    
    if (!why) {
      throw new Error('Change must have a Why section');
    }
    
    if (!whatChanges) {
      throw new Error('Change must have a What Changes section');
    }

    const deltas = this.parseDeltas(whatChanges);

    return {
      name,
      why: why.trim(),
      whatChanges: whatChanges.trim(),
      deltas,
      metadata: {
        version: '1.0.0',
        format: 'openspec-change',
      },
    };

View on GitHub (pinned to 6926ccb18a)

When it happens

Trigger: Thrown at src/core/parsers/markdown-parser.ts:61 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Fission-AI/OpenSpec@6926ccb18a (2026-08-25). Data as JSON: /api/errors/6dcd812dffad86cf. Report an issue: GitHub.