Troubleshooting

Product page demo returns an error

• Ensure the server is running and POST /agent/demo is reachable
• Check browser console for network errors
• Demo uses ephemeral sessions — clear localStorage.agentic_demo_session if a session is corrupted

Workspace chat: "project_slug required"

Pass project_slug in chat/stream requests. The workspace UI does this automatically via PROJECT_SLUG.

Agent doesn't change files

• Confirm you're in Develop or Test stage (Discover/Design only write docs)
• Check LLM provider status via GET /agent/status
• Without API keys, the built-in fallback has limited edit capability

Stage strip not visible

Open the right panel → AI Chat tab. The PDLC strip appears above the chat messages.

Workflow state not saving

• Workspace projects must exist in the database
• Demo projects use filesystem .workflow.json under _demo/{session_id}/

Stream disconnects

SSE requires a stable connection. Proxies should disable buffering (X-Accel-Buffering: no is set on the stream response).

Files changed but editor stale

The workspace listens for files_changed SSE events and calls refreshFiles(). Manually click refresh in the file tree if needed.