12 KiB
12 KiB
Section 3: WORKFLOW Modules - Audit & Action Plan
Date: December 27, 2025
Status: Finalized for Implementation
Scope: Planner, Writer, Automation (Linker & Optimizer excluded - not active modules)
3.1 Planner
Route: /planner/keywords
Files: pages/Planner/Keywords.tsx, pages/Planner/Clusters.tsx, pages/Planner/ClusterView.tsx, pages/Planner/Ideas.tsx, pages/Planner/KeywordOpportunities.tsx
Tabs: Keywords, Clusters, Ideas
Current Functionality
- Keywords: CRUD, bulk status updates, auto-cluster AI, filters
- Clusters: CRUD, bulk operations, auto-generate ideas AI
- Ideas: CRUD, bulk queue to writer, filters
- Flow: Keywords → Auto-Cluster → Clusters → Auto-Generate Ideas → Ideas → Queue to Writer
Issues to Address
| # | Issue | Priority | Action |
|---|---|---|---|
| 1 | KeywordOpportunities page exists but orphaned | High | DELETE - Remove pages/Planner/KeywordOpportunities.tsx and all references to it. Add Keywords page is the source of truth for seed keywords |
| 2 | No "Add to Existing Cluster" | Medium | Add option to assign keywords to existing clusters (not just create new) |
| 3 | No cluster progress indicator | High | Show which clusters already have ideas generated (badge/indicator) |
| 4 | Ideas missing queued count | Medium | Add indicator showing how many ideas are pending vs processed |
| 5 | Cluster → Ideas transition unclear | Medium | Make it clear which clusters need ideas generated |
| 6 | No return path from Ideas to source cluster | Low | Make cluster name clickable on Ideas page to navigate back |
Issues NOT Being Addressed (Per Discussion)
| Issue | Reason |
|---|---|
| No cluster merge/split | Risk of breaking functional workflow, complex implementation |
Implementation Notes
For Issue #1 (Remove KeywordOpportunities):
- Delete file:
pages/Planner/KeywordOpportunities.tsx - Remove route from App.tsx or router config
- Remove any navigation links to
/planner/keyword-opportunities - Remove from sidebar if present
- The Add Keywords page (
/setup/add-keywords) is the active workflow item for seed keywords
For Issue #3 (Cluster progress indicator):
- On Clusters table, show badge: "X ideas" or "No ideas yet"
- Visual distinction between clusters with/without ideas
- Consider color coding or icon
For Issue #5 (Cluster → Ideas transition):
- Add "Generate Ideas" button prominently on clusters without ideas
- Filter option: "Show clusters without ideas"
3.2 Writer
Route: /writer/tasks
Files: pages/Writer/Tasks.tsx, pages/Writer/Drafts.tsx, pages/Writer/ContentView.tsx, pages/Writer/Images.tsx, pages/Writer/Review.tsx, pages/Writer/Published.tsx
Tabs: Queue, Drafts, Images, Review, Published
Current Functionality
- Tasks (Queue): CRUD, generate content (row action only), generate images bulk
- Drafts: List drafts, view details, status updates
- Images: Grouped by content, image generation
- Review: Status=review filter, publish to WordPress
- Published: Status=published, WordPress sync status
Issues to Address
| # | Issue | Priority | Action |
|---|---|---|---|
| 1 | Status progression confusion | High | Streamline Draft → Review → Published flow - should not require navigating different pages for status changes |
| 2 | Images detached from content workflow | High | Integrate images into content workflow - show/manage images within content view |
| 3 | ContentView shows tags and categories twice | High | Fix template to display tags and categories only once |
Issues NOT Being Addressed (Per Discussion)
| Issue | Reason |
|---|---|
| No bulk content generation | Not an issue per current workflow |
| No content editing | Not an issue per current workflow |
| No manual task creation | Not an issue per current workflow |
| No content regeneration | Not an issue per current workflow |
| Review → Published manual only | Not an issue per current workflow |
| ContentView missing actions bar | Not an issue per current workflow |
| No send_to_linker action | Linker not active module |
Implementation Notes
For Issue #1 (Status progression):
- Allow status changes from any tab/view without forcing navigation
- Consider unified content list with status filter instead of separate pages
- Or add status change dropdown/buttons within each view
For Issue #2 (Images integration):
- Show image thumbnails within ContentView
- Allow image generation from ContentView
- Show image count on content list items
For Issue #3 (Duplicate tags/categories):
- Audit ContentView.tsx template
- Find and remove duplicate rendering of tags and categories
- Should display once in appropriate section
3.3 Automation
Route: /automation
Files: pages/Automation/AutomationPage.tsx (or Dashboard.tsx)
Tabs: None (single page)
Current Functionality
- Pipeline overview (7 stages: Keywords → Clusters → Ideas → Tasks → Content → Image Prompts → Images)
- Schedule configuration (frequency, time, enable/disable)
- Run controls (Run Now, Pause, Resume)
- Real-time progress polling
- Metrics display and activity log
Issues to Address
| # | Issue | Priority | Action |
|---|---|---|---|
| 1 | No stage-by-stage control | Medium | Add toggles to enable/disable individual pipeline stages |
| 2 | No review gate config | Low | Add UI to configure review gate rules (Stage 7) |
| 3 | No error recovery | High | Add retry capability for failed items (per-item or per-stage) |
| 4 | No batch size config | Medium | Add setting to throttle items processed per run |
| 5 | No dry run/preview | Medium | Add preview mode to show what WOULD be processed before running |
| 6 | Activity log not filterable | Medium | Add filters: by stage, status, date |
| 7 | Credit estimation unclear | High | Clarify labeling - consistent terminology (credits vs content pieces) |
| 8 | Run history depth unknown | Low | Add pagination to run history |
| 9 | No indication of manual vs automated | Low | Show source indicator for processed items |
Implementation Notes
Critical Constraint: All changes must NOT affect the actual AI functions that run on module pages. Automation uses the same functions - only UI/control changes, not function logic.
For Issue #1 (Stage toggles):
- Add on/off toggle for each of the 7 stages
- When stage is off, automation skips it
- Visual indicator showing which stages are active
For Issue #3 (Error recovery):
- Show failed items in activity log with "Retry" button
- Option to retry all failed items from a run
- Clear error messages explaining what failed
For Issue #5 (Dry run/preview):
- "Preview Run" button shows list of items that would be processed
- Shows count per stage
- User can then confirm or cancel
For Issue #7 (Credit estimation):
- Use consistent terminology matching the pricing simplification plan
- Show estimated cost before running
3.4 Linker
Status: ❌ NOT ACTIVE MODULE - Skipped
Not part of current phase. No issues to address.
3.5 Optimizer
Status: ❌ NOT ACTIVE MODULE - Skipped
Not part of current phase. No issues to address.
3.6 WORKFLOW Cross-Module Issues
Issues to Address
| # | Issue | Priority | Action |
|---|---|---|---|
| 1 | No Planner → Writer visibility | Medium | After queuing ideas to writer, provide clear feedback and link to Writer |
| 2 | No cross-module notifications | High | Log all AI runs in notification dropdown (bell icon) with correct end results |
| 3 | Progress modals have wrong texts | High | Fix placeholder text, wrong wording, inaccurate counts (showing "X" or placeholders) |
| 4 | Progress modal counts inaccurate | High | Ensure counts reflect actual items being processed |
| 5 | No breadcrumb navigation | Medium | Add breadcrumbs showing workflow path (Cluster → Idea → Task → Content) |
| 6 | No "Next Step" suggestions | Medium | After each action, suggest what to do next |
Issues NOT Being Addressed (Per Discussion)
| Issue | Reason |
|---|---|
| No Writer → Linker integration | Linker not active module |
| No Writer → Optimizer integration | Optimizer not active module |
Implementation Notes
For Issue #2 (Notifications):
- Bell icon dropdown should show log of all AI function runs
- Each entry shows: function type, status (success/failed/in-progress), timestamp
- Include runs from: Clustering, Idea Generation, Content Generation, Image Generation
- Show result: "Generated 5 ideas from Cluster X" or "Failed: insufficient credits"
- Link to relevant content/page
For Issues #3 & #4 (Progress modals):
- Audit all progress modals across modules
- Replace placeholder text ("X", "processing...", wrong labels)
- Ensure counts match actual items:
- "Processing 5 of 12 keywords" (not "Processing X of Y")
- "Generated 3 ideas" (actual count, not placeholder)
- Match text to actual AI function being performed
- Consistent terminology across all modals
Progress Modals to Audit:
- Keyword clustering modal
- Idea generation modal
- Content generation modal
- Image prompt extraction modal
- Image generation modal
- Any bulk operation modals
Summary
Total Issues by Section
| Section | High | Medium | Low | Total |
|---|---|---|---|---|
| 3.1 Planner | 2 | 3 | 1 | 6 |
| 3.2 Writer | 3 | 0 | 0 | 3 |
| 3.3 Automation | 2 | 5 | 2 | 9 |
| 3.4 Linker | - | - | - | Skipped |
| 3.5 Optimizer | - | - | - | Skipped |
| 3.6 Cross-Module | 2 | 4 | 0 | 6 |
| TOTAL | 9 | 12 | 3 | 24 |
High Priority Items
- Planner - Delete KeywordOpportunities page and all references
- Planner - Add cluster progress indicator (which have ideas)
- Writer - Fix status progression confusion
- Writer - Integrate images into content workflow
- Writer - Fix duplicate tags/categories in ContentView
- Automation - Add error recovery/retry for failed items
- Automation - Clarify credit/content terminology
- Cross-Module - Fix progress modal texts and counts
- Cross-Module - Implement notification logging for AI runs
Files to Delete
| File | Reason |
|---|---|
pages/Planner/KeywordOpportunities.tsx |
Orphaned page, Add Keywords is source of truth |
Files to Modify
| File | Changes |
|---|---|
pages/Planner/Keywords.tsx |
Remove any KeywordOpportunities references |
pages/Planner/Clusters.tsx |
Add ideas count badge, "Generate Ideas" prominence |
pages/Planner/Ideas.tsx |
Add queued count indicator, clickable cluster name |
pages/Writer/Tasks.tsx |
Streamline status changes |
pages/Writer/Drafts.tsx |
Streamline status changes |
pages/Writer/ContentView.tsx |
Fix duplicate tags/categories, integrate images |
pages/Writer/Images.tsx |
Better integration with content workflow |
pages/Writer/Review.tsx |
Streamline status changes |
pages/Automation/AutomationPage.tsx |
Stage toggles, batch size, preview, filters, error retry |
| All progress modal components | Fix placeholder text, counts, wording |
| Notification dropdown component | Add AI run logging |
| Router/App.tsx | Remove KeywordOpportunities route |
| Sidebar component | Remove KeywordOpportunities link if present |
Backend Work Required
| Area | Work |
|---|---|
| Automation stage control | API to save stage enable/disable preferences |
| Automation batch size | API to save batch size setting |
| Error recovery | API to retry failed items |
| Notification logging | Ensure AI runs are logged for notification display |