2.3 KiB

Raw Blame History

WDS Project Analysis System - Guide

Purpose: Reference guide for how the project analysis system works

System Overview

The WDS agent activation uses a simple chain:

Launcher → Presentation → Router → Analysis

Each file has ONE job.

Files and Their Purpose

Entry Points

getting-started/agent-activation/wds-freya-ux.md (Launcher)

Tells agent which persona to embody
Points to presentation file

Presentations

agents/presentations/freya-presentation.md

Shows complete agent introduction
Establishes personality
Redirects to router

Router

workflows/project-analysis/project-analysis-router.md

Checks project conditions (A→B→C→D→E)
Routes to ONE analysis file
Pure routing logic only

Analysis Files

workflows/project-analysis/analysis-types/[type].md

Analyzes project based on route
Presents project-focused status (agent-agnostic)
Asks user what they want to work on

Work-Type Files

workflows/project-analysis/work-types/[type]-work.md

Routes based on work user selected
Recommends appropriate agent if needed
Handles seamless handoffs

How It Works

User types: @wds-freya-ux.md
Launcher loads: freya-ux.agent.yaml (persona)
Agent shows: freya-presentation.md (full introduction)
Presentation redirects to: project-analysis-router.md
Router checks conditions and routes to ONE analysis file
Analysis presents ALL project work and asks what user wants
User selects work → routes to work-type file
Work-type file recommends agent if needed

Key Principles

One job per file - No mixing concerns
Presentation first - Human connection before analysis
Pure routing - Simple logic, no improvisation
Agent-agnostic analysis - Show ALL work, let user choose
Work-based routing - Route by work type, not agent domain

For Developers

To modify agent presentations:

Edit: agents/presentations/[agent]-presentation.md

To modify routing logic:

Edit: project-analysis-router.md

To modify analysis:

Edit: analysis-types/[type]-analysis.md

To modify work-type routing:

Edit: work-types/[type]-work.md

This is a reference guide. The actual entry point is instructions.md.

2.3 KiB Raw Blame History