# @lssm-tech/example.agent-workflow-command-center

Website: https://contractspec.io

**Agent Workflow Command Center - All-in-one operator cockpit for supervised AI agents in business workflows.**

## What This Demonstrates

Agent Workflow Command Center is a ContractSpec example for operating supervised AI agents inside business workflows. It combines:

- **Agent Management:** Fleet overview, configuration, tool permissions, lifecycle controls
- **Workflow Orchestration:** State-machine workflows with agent assignments
- **Human Review:** Review queue with approve/reject/escalate actions
- **Governance:** Tool policies, risk thresholds, blocked actions
- **Audit Trail:** Complete event timeline with deterministic evidence
- **ROI & Handover:** Adoption metrics and handover readiness checklist

## Business Scenario

A PME industrielle (85 employees) undergoing finance transformation:

- Finance team under pressure with RAF departure
- Cash tension and reporting delays
- Fragmented Excel/BI tooling
- Weak or outdated finance procedures

NDconsulting installs supervised AI-assisted workflows and helps the client operate the system after handover.

## Core Demo Message

"ContractSpec delivers a controllable operating system where the client team can:
- Manage agents and assign them to workflows
- Review AI-generated outputs before operational use
- Enforce governance policies and block risky actions
- Inspect audit logs and track adoption/ROI
- Prove what happened through deterministic evidence"

## Included Agents

1. **Cash Aging Agent** - Prioritizes receivables follow-up using deterministic aging rules
2. **Reporting Narrative Agent** - Drafts reporting commentary with variance analysis
3. **Procedure Draft Agent** - Structures finance procedures with roles and controls
4. **Mission Intake Agent** - Triages transformation requests and classifies urgency
5. **AI Adoption Coach** - Tracks use cases and ROI without employee surveillance

## Workflows

1. **Cash Recovery Prioritization** - Intake → Agent Analysis → Human Review → Approved/Changes Requested
2. **Monthly Reporting Narrative** - Data Input → Narrative Draft → Variance Review → Finalization
3. **Finance Procedure Drafting** - Request → Procedure Structure → Control Review → Publication
4. **Mission Intake Triage** - Request → Classification → Priority Assignment → Follow-up
5. **AI Adoption / ROI Logging** - Usage Event → Impact Calculation → Trend Analysis

## Canonical Demo Path

1. Open `/sandbox?template=agent-workflow-command-center`
2. Start on the Landing screen - understand the value proposition
3. Enter the Command Center Overview - see active agents and workflows
4. Inspect the Cash Aging Agent - review allowed tools and governance
5. Open the Cash Recovery workflow - see state machine
6. Assign the Cash Aging Agent to the workflow
7. Trigger a deterministic agent run
8. Inspect run logs and emitted events
9. Open the review queue
10. Approve one recommendation, request changes on another
11. Show workflow state transition
12. Simulate a high-risk tool call - show it's blocked
13. Pause an agent, then resume after policy review
14. Open ROI & Handover - generate checklist
15. Export or display replay/audit proof

## Safety Boundaries

- All agent outputs require human review before operational use
- No real emails, payment instructions, or accounting entries sent
- No connection to live finance systems
- Synthetic fixtures only - no real client or financial data
- Deterministic and offline-safe
- Drafts/recommendations only, not operational commands
- Tracks workflow ROI, not intrusive employee surveillance

## Core Entities

- **AgentProfile** - Agent configuration, status, autonomy level, allowed tools
- **WorkflowTemplate** - Workflow definitions with steps and transitions
- **WorkflowInstance** - Running workflow with current state and assignments
- **AgentAssignment** - Links agents to workflow steps
- **AgentRun** - Execution record with inputs, outputs, events
- **HumanReview** - Review queue with decisions and feedback
- **ToolPolicy** - Governance rules for tool usage
- **AuditEvent** - Immutable event log
- **AdoptionMetric** - ROI and usage tracking

## Public Entry Points

- Export `.` resolves through `./src/index.ts`
- Export `./agent` resolves through `./src/agent/index.ts`
- Export `./workflow` resolves through `./src/workflow/index.ts`
- Export `./review` resolves through `./src/review/index.ts`
- Export `./governance` resolves through `./src/governance/index.ts`
- Export `./fixtures` resolves through `./src/fixtures/index.ts`
- Export `./proof` resolves through `./src/proof/index.ts`
- Export `./ui` resolves through `./src/ui/index.ts`
- Export `./example` resolves through `./src/example.ts`

## Local Commands

- `bun run dev` - Development build
- `bun run build` - Production build
- `bun run test` - Run tests
- `bun run typecheck` - TypeScript check
- `bun run lint` - Lint and fix
- `bun run preflight` - Full validation

## Architecture

- `src/agent/` - Agent profile domain
- `src/workflow/` - Workflow template and instance domain
- `src/review/` - Human review domain
- `src/governance/` - Tool policies and governance
- `src/fixtures/` - Synthetic demo data
- `src/proof/` - Replay evidence
- `src/ui/` - Preview components and screens

## Notes

Works alongside `@lssm-tech/lib.contracts-spec`, `@lssm-tech/lib.design-system`, `@lssm-tech/lib.schema`.