Enhancement: Process Landscape — Central Process Overview with Provenance

[enthali]

Intent

Anchor the process overview as a first-class documentation artifact so it is automatically pulled into the change workflow.

Problem

Process knowledge is scattered across specs, requirements, and agent files. New users have no chance without a central overview.
There is no single point of entry for "which workflows exist and how do they relate?"

Solution

Central process landscape (docs/syspilot/process_landscape.rst) showing:

• Which workflows exist
• Which agents are involved
• Which User Stories the workflows originate from
• Which Requirements and Specs concretize the workflow

Structure (minimal-invasive)

1. Mermaid or needflow diagram: US_* -> REQ_WF_* -> SPEC_* -> Agent
2. Workflow catalog (ID, name, involved agents, trigger, input/output)
3. Provenance matrix (Workflow -> US IDs -> REQ IDs -> SPEC IDs)
4. Navigation in docs/index.rst under "Specs & Traceability"

Traceability (planned)

• User Story: SYSPILOT_US_DOC_PROCESS_LANDSCAPE
• Requirements: SYSPILOT_REQ_DOC_PROCESS_LANDSCAPE + SYSPILOT_REQ_DOC_TRACEABILITY_MATRIX
• Design: Anchored in spec_traceability.rst or spec_doc_structure.rst

Chaining for Automatic Pull-Through

• Workflow REQs link to the documentation REQ for the Process Landscape
• → Workflow changes make the documentation impact visible in the change process

Agent Ontology Extension

• Agents as explicit roles in the landscape (change, implement, verify, ...)
• Later expansion: Agent-Relationship-View (handoff, predecessor, successor)

Verify Integration

• Verify Agent checks consistency between documented process landscape and agent workflow sections
• Report output: checklist (workflow step present? agent responsibility consistent? handoff consistent?)

Status

Parked: waiting for structural rework to complete. Implementation follows as a separate, small change.

[enthali]

Partial coverage in v0.3.0: The new docs/workflows.md (from #15) covers a significant part of this issue's scope — central process overview with workflow descriptions, agent responsibilities, decision guide, and Mermaid workflow diagrams.

What's still missing from this issue:

• needflow/provenance matrix (automated US → REQ → SPEC → Agent tracing)
• Verify Agent integration (consistency checks between process landscape and agent specs)

Keeping this parked as planned — the remaining scope depends on the agent structure rework.