CascadingDev/docs
rob 33b550ad5b docs: complete update for AI normalization architecture
Updated all documentation to reflect the new two-tier extraction system:

**workflow-marker-extraction.puml:**
- Completely rewritten to show AI normalization flow
- Documents agents.normalize_discussion() as primary method
- Shows simple line-start fallback for explicit markers
- Includes natural conversation examples vs. explicit markers
- Demonstrates resilience and cost-effectiveness

**AUTOMATION.md:**
- Restructured "Conversation Guidelines" section
- Emphasizes natural conversation as recommended approach
- Clarifies AI normalization extracts from conversational text
- Documents explicit markers as fallback when AI unavailable
- Explains two-tier architecture benefits

**diagrams-README.md:**
- Already updated in previous commit

All documentation now accurately reflects:
 AI-powered extraction (agents.py) for natural conversation
 Simple fallback parsing (workflow.py) for explicit markers
 Multi-provider resilience (claude → codex → gemini)
 No strict formatting requirements for participants

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-02 20:04:09 -04:00
..
AUTOMATION.md docs: complete update for AI normalization architecture 2025-11-02 20:04:09 -04:00
DESIGN.md docs: comprehensive AI configuration documentation update 2025-11-01 21:48:25 -03:00
INSTALL.md 1st commit 2025-10-27 20:17:35 -03:00
PROGRESS.md docs: add comprehensive implementation progress tracker 2025-11-01 22:13:56 -03:00
ai-provider-fallback.puml docs: update PlantUML diagrams for multi-provider fallback and regex marker extraction 2025-11-02 13:05:00 -04:00
architecture-overview.puml docs: Add comprehensive PlantUML architecture diagrams 2025-10-31 22:52:02 -03:00
cascading-rules.puml docs: Add comprehensive PlantUML architecture diagrams 2025-10-31 22:52:02 -03:00
commit-workflow.puml docs: update PlantUML diagrams for multi-provider fallback and regex marker extraction 2025-11-02 13:05:00 -04:00
diagrams-README.md docs: update diagrams-README to reflect AI normalization architecture 2025-11-02 18:52:00 -04:00
directory-structure.puml updated uml diagrams 2025-10-31 23:19:35 -03:00
discussion-stages.puml docs: update PlantUML diagrams for multi-provider fallback and regex marker extraction 2025-11-02 13:05:00 -04:00
file-lifecycle.puml updated uml diagrams 2025-10-31 23:19:35 -03:00
patcher-pipeline.puml fix: correct PlantUML syntax in patcher-pipeline diagram 2025-11-02 13:22:25 -04:00
voting-system.puml docs: update PlantUML diagrams for multi-provider fallback and regex marker extraction 2025-11-02 13:05:00 -04:00
workflow-marker-extraction.puml docs: complete update for AI normalization architecture 2025-11-02 20:04:09 -04:00
workflow-marker-extraction.svg docs: complete update for AI normalization architecture 2025-11-02 20:04:09 -04:00