P-2: Start Scene

[spuentesp]

Category: play | Epic: 4 | Priority: high

Summary

Begin a new scene within an active story. Sets location, participants,
purpose, and generates opening narration. Transitions to the turn loop.

Acceptance Criteria

• mongodb_create_scene creates scene document with story_id
• Scene purpose affects narrator tone and pacing
• Location validated as existing entity
• Participating entities tracked in scene document
• Opening narration generated via Narrator agent
• Opening turn appended to scene turns array
• Scene status set to 'active'
• Context assembly includes location and entity data

Dependencies

This use case depends on:

• DL-4
• P-1

Blocks

This use case blocks:

• P-3

Implementation

Layer: 2

Files to modify:

• packages/agents/src/monitor_agents/orchestrator.py
• packages/agents/src/monitor_agents/narrator.py
• packages/agents/src/monitor_agents/context_assembly.py

NEO4J Operations:

• neo4j_get_entity (authority: *)
• neo4j_list_entities (authority: *)

MONGODB Operations:

• mongodb_create_scene (authority: *)
• mongodb_append_turn (authority: *)

QDRANT Operations:

• qdrant_search (authority: *)

Notes:

• Scene opening sets the mood
• Purpose helps Narrator choose appropriate style
• Consider weather/time of day from world time

Testing Requirements

Minimum coverage: 80%

Unit tests:

• test_start_scene_basic: scene created
• test_start_scene_with_location: location validated
• test_start_scene_opening: narration generated
• test_start_scene_context: context assembled

Integration tests:

• test_scene_to_turn_flow: P-2 -> P-3 transition
• test_scene_opening_quality: narration appropriate

References

Documentation:

• docs/USE_CASES.md#p-2-start-scene
• docs/architecture/AGENT_ORCHESTRATION.md
  Code:
• packages/agents/src/monitor_agents/orchestrator.py
• packages/data-layer/src/monitor_data/schemas/scenes.py

---

Generated from /home/sebas/monitor2/docs/use-cases/play/P-2.yml