analyze-story

Steps:

1. Read the Extracted Intent

• Read the extracted intent json document.

2. Read the provided document

• read the conents of the raw_prompt field in the extracted intent json document, either the file under the provided path or the verbatim text.

2. Create Analysis JSON File

• create a new json file in the same directory as the extracted intent json document, using the same filename but with the suffix .analysis.json. e.g. "create-object-with-validation.analysis.json"
• The json will follow /schema/analysis.schema.json.
• set the raw_request to the file path, relative to repo root, of the provided document, or to the verbatim text provided if no document was sent.

3. Analyze the Capability

Break down what's being requested:

CAPABILITY ANALYSIS:
├── Core action: [The main thing user does]
├── Inputs required: [What data is needed?]
├── Outputs expected: [What should result?]
├── State changes: [What data is modified?]
└── Side effects: [Notifications, logs, etc.]

Map to system components:
├── UI affected: [Screens, forms, buttons]
├── API endpoints: [New or modified]
├── Database changes: [Schema, queries]
└── External services: [Third-party integrations]

Fill in the appropriate section of the JSON.

4. Examine Acceptance Criteria

For each acceptance criterion:
- review the extracted crietion
- confirm testability, re-write scenario if not testable
- identify dependencies, that is other criteria this relates to

Ensure we have acceprtrance criteria for happy path, error handling, boundary conditions, and permission/access scenarios. Generate them if missing. 

5. Identify Edge Case

Systematically consider:

INPUT EDGE CASES:
□ Empty/null values
□ Maximum length inputs
□ Special characters (unicode, emojis)
□ Invalid formats
□ Boundary values

STATE EDGE CASES:
□ First-time use (no existing data)
□ Maximum data limits
□ Concurrent modifications
□ Partial completion states

USER EDGE CASES:
□ No permissions
□ Expired sessions
□ Multiple devices
□ Interrupted workflows

SYSTEM EDGE CASES:
□ External service unavailable
□ Network timeout
□ Database errors
□ Rate limiting

And capture criteria for each edge case under edge_cases section.