docs(05-01): complete NLU cleanup plan

Tasks completed: 2/2 - Task 1: Remove NLU/Claude nodes and add Keyword Router - Task 2: Add persistent Telegram menu SUMMARY: .planning/phases/05-polish-deploy/05-01-SUMMARY.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 21:11:01 -05:00
parent a29f444e08
commit 9ae500cdf5
2 changed files with 119 additions and 15 deletions
@@ -0,0 +1,102 @@
+# Phase 5 Plan 01: NLU Cleanup Summary
+
+**Replaced Claude/NLU with keyword-based routing and persistent Telegram menu buttons**
+
+## Frontmatter
+
+```yaml
+phase: 05-polish-deploy
+plan: 01
+subsystem: workflow-routing
+tags: [n8n, telegram, keyword-routing, menu]
+
+dependency-graph:
+  requires: [04-01]
+  provides: [keyword-router, persistent-menu, nlu-removal]
+  affects: []
+
+tech-stack:
+  added: []
+  patterns: [keyword-switch-routing, telegram-reply-keyboard]
+
+key-files:
+  created: []
+  modified: [n8n-workflow.json]
+
+decisions:
+  - keyword-order-matters: "restart before start to avoid substring match issues"
+  - combined-tasks: "Task 1 and Task 2 merged for atomic workflow change"
+  - no-emojis-on-buttons: "Clean button text for reliable keyword matching"
+
+metrics:
+  duration: 4m
+  completed: 2026-02-01
+```
+
+## What Changed
+
+### Removed Nodes (NLU/Claude)
+- Prepare Claude Request
+- Claude Intent Parser (HTTP Request to api.anthropic.com)
+- Parse Intent (Code node)
+- Intent Router (Switch node)
+- Send Unknown Intent
+- Send Intent Error
+- Send Stats Placeholder
+- Format Echo / Send Echo
+
+### Added/Modified Nodes
+
+**Keyword Router** (renamed from Route Message)
+- 7 keyword rules with case-insensitive matching
+- Order: /start, status, restart, start, stop, update, logs
+- Fallback output connects to Show Menu
+
+**Show Menu** (new HTTP Request node)
+- Sends persistent keyboard with 6 buttons
+- Layout: Status solo, then paired (Start/Stop, Restart/Update, Logs)
+- is_persistent: true, resize_keyboard: true
+
+### Code Updates
+- Parse and Match: Works with keyword routing, extracts container from message
+- Parse Action Command: Parses action and container from message text
+- Match Container: References Parse Action Command instead of Parse Intent
+- Parse Logs Command: Parses container name and line count from message
+
+## Commits
+
+| Commit | Description |
+|--------|-------------|
+| a29f444 | feat(05-01): replace NLU/Claude with keyword routing |
+
+## Verification Results
+
+All checks passed:
+- Zero Claude/NLU nodes remain
+- Zero Anthropic API references in workflow
+- Keyword Router handles: /start, status, restart, start, stop, update, logs
+- Fallback routes to Show Menu
+- Persistent menu has 6 buttons with is_persistent: true
+- All keyword routes connect to correct handler nodes
+
+## Deviations from Plan
+
+### Combined Tasks
+Tasks 1 and 2 were executed as a single atomic change because:
+- Show Menu node required for Keyword Router fallback connection
+- Keyword Router updates and Show Menu creation are interdependent
+- Single commit ensures workflow remains valid at all times
+
+### Rule Order Optimization
+Added rule order optimization to handle substring conflicts:
+- `/start` before `start` (command vs keyword)
+- `restart` before `start` (restart contains "start")
+
+## Next Steps
+
+The workflow now operates without Claude API dependency:
+- All commands work via typed keywords
+- Button taps trigger same keyword routes
+- Unknown input shows menu (not error)
+
+Ready for Phase 5 Plan 02 (if any additional polish plans exist) or deployment.