docs(05): capture phase context
Phase 05: Polish & Deploy - Implementation decisions documented - Phase boundary established Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,59 @@
|
||||
# Phase 5: Polish & Deploy - Context
|
||||
|
||||
**Gathered:** 2026-01-31
|
||||
**Status:** Ready for planning
|
||||
|
||||
<domain>
|
||||
## Phase Boundary
|
||||
|
||||
Production-ready deployment on Unraid — remove NLU/Claude nodes from workflow (replace with keyword routing), add error handling, write deployment instructions, and perform end-to-end testing. No new features.
|
||||
|
||||
</domain>
|
||||
|
||||
<decisions>
|
||||
## Implementation Decisions
|
||||
|
||||
### NLU removal approach
|
||||
- Rip and replace — remove Claude nodes entirely, build fresh keyword routing
|
||||
- Add persistent Telegram menu button for command discovery
|
||||
- Menu structure: grouped — "Status" and "Actions" (submenu with start/stop/restart/update/logs)
|
||||
- Keywords still work for power users who type directly
|
||||
|
||||
### Error messaging
|
||||
- Minimal error messages — "Failed to start plex" without verbose details
|
||||
- Infrastructure errors (Docker socket unreachable) get specific message: "Cannot connect to Docker"
|
||||
- Success messages terse — "✓ plex started"
|
||||
|
||||
### Deployment packaging
|
||||
- README only — step-by-step instructions in markdown
|
||||
- Workflow JSON committed to repo
|
||||
- Sensitive values (Telegram user ID) moved to n8n credentials system — not hardcoded in workflow JSON
|
||||
- No troubleshooting section — focused on initial setup only
|
||||
|
||||
### Claude's Discretion
|
||||
- README location (root vs docs folder)
|
||||
- Whether to include retry buttons on retriable errors
|
||||
- Exact menu button labels and grouping UX
|
||||
|
||||
</decisions>
|
||||
|
||||
<specifics>
|
||||
## Specific Ideas
|
||||
|
||||
- User wants UX buttons in Telegram rather than typing commands
|
||||
- Persistent menu always visible, not just on unknown input
|
||||
- Credentials approach allows sharing workflow without exposing user ID
|
||||
|
||||
</specifics>
|
||||
|
||||
<deferred>
|
||||
## Deferred Ideas
|
||||
|
||||
None — discussion stayed within phase scope
|
||||
|
||||
</deferred>
|
||||
|
||||
---
|
||||
|
||||
*Phase: 05-polish-deploy*
|
||||
*Context gathered: 2026-01-31*
|
||||
Reference in New Issue
Block a user