Skip to content

feat: Multi-agent workflow system for Scribe map automation#4

Merged
rmodis1 merged 2 commits intomainfrom
feat/mcp-phase-a-structured-output
Jan 19, 2026
Merged

feat: Multi-agent workflow system for Scribe map automation#4
rmodis1 merged 2 commits intomainfrom
feat/mcp-phase-a-structured-output

Conversation

@rmodis1
Copy link
Copy Markdown
Owner

@rmodis1 rmodis1 commented Jan 19, 2026

Summary

  • Implements Gas Town-inspired multi-agent architecture for structured map creation workflows
  • Adds 5 agent prompt templates (documentation review, flowchart extraction, mapspec creation, map builder, validation review)
  • Creates workflow state management with unique IDs (e.g., scribe-a7k2m)
  • Configures Salesforce MCP with 6 authenticated orgs
  • Reorganizes project structure (moves historical docs to archive)

Key Features

Multi-Agent System

  • Agent modes: Orchestrator, Documentation Review, Data Ingestion, MapSpec Creation, Map Builder, Validation Review
  • Workflow types: flowchart_to_map, modify_existing
  • Human checkpoints: Extraction Review, Spec Approval, Import Approval (requires exact phrase)

New Scripts

  • scripts/ensure_mcp_servers.py - Health checks for MCP infrastructure
  • scripts/workflow_state.py - Persistent workflow state with unique IDs
  • scripts/handoff.py - Session continuity document generation
  • scripts/workflow_orchestrator.py - CLI for workflow management

Configuration

  • Salesforce MCP configured with 6 orgs: FullCopy, CCxDEV, FUT, SIT, BST, UAT
  • Log files now write to logs/ folder (cleaner project root)

Test plan

  • Run python -m scripts.ensure_mcp_servers - verify all checks pass
  • Run python -m scripts.workflow_state create --type flowchart_to_map --description "Test" - verify workflow creation
  • Test Salesforce MCP connectivity with authenticated orgs
  • Verify existing tests still pass: .venv/bin/pytest tests/ -m unit

🤖 Generated with the assistance of Claude Code

rmodis1 and others added 2 commits January 16, 2026 15:58
Implement Gas Town-inspired multi-agent architecture for structured map creation:

**New Agent System:**
- agents/prompts/ - 5 mode-specific prompt templates
- agents/workflows/ - 2 workflow definitions (flowchart_to_map, modify_existing)
- agents/AGENTS.md - Agent system documentation

**New Infrastructure Scripts:**
- scripts/ensure_mcp_servers.py - MCP server health checks
- scripts/workflow_state.py - Workflow state management with unique IDs
- scripts/handoff.py - Session handoff document generation
- scripts/workflow_orchestrator.py - CLI orchestrator

**Configuration Updates:**
- .mcp.json - Added Salesforce MCP with 6 orgs (FullCopy, CCxDEV, FUT, SIT, BST, UAT)
- .vscode/mcp.json - Synced SF org configuration
- .gitignore - Added logs/ folder

**Code Changes:**
- MCP servers now log to logs/ folder instead of project root
- CLAUDE.md updated with multi-agent workflow documentation

**Project Cleanup:**
- Moved 6 status docs to docs/archive/ (historical reference)
- Deleted docs/LLM_CONTEXT_OLD.md (superseded)
- Deleted root log files (now in logs/)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@rmodis1 rmodis1 merged commit 4503234 into main Jan 19, 2026
6 checks passed
@rmodis1 rmodis1 deleted the feat/mcp-phase-a-structured-output branch January 19, 2026 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant