docs: update agentic-workflows.md to remove decomposition from issue triage

[github-actions]

Component

Documentation

Bug Description

docs/architecture/agentic-workflows.md describes issue triage as including a decomposition step that no longer exists. PR #2223 (commit 3420081) removed the "Decompose Oversized Issues" capability from .github/agents/issue-triage.agent.md and dropped the create-issue safe-output from .github/workflows/issue-triage.md, but the architecture documentation was not updated to match.

Three areas are stale:

1. Mermaid flowchart — Decision node F ("Scope too broad for single deliverable?") and action node G ("Decompose into sub-issues") still appear in the TRIAGE subgraph. The flow edges E --> F, F -- Yes --> G, G --> I, and F -- No --> H route through the decomposition path that no longer exists. The correct post-PR flow goes directly from E to H (the agent-ready evaluation).

2. Workflow details table (line 97) — The "Key Actions" column for Issue Triage reads: "Classify, detect duplicates, assess quality, decompose, label, evaluate readiness." Decompose should be removed.

3. Tip block (lines 103–104) — States "The triage agent only classifies, labels, and optionally decomposes issues." Decomposition no longer occurs; the tip should reflect the current behaviour, which is classifying, applying type/area/priority labels, and assessing agent-ready criteria.

Expected Behavior

After the update the page should:

• Remove nodes F and G from the TRIAGE subgraph in the Mermaid diagram.
• Replace the edges E --> F / F -- Yes --> G / G --> I / F -- No --> H with a direct E --> H.
• Remove "decompose" from the Key Actions cell in the workflow details table.
• Update the tip block to say the agent classifies issues, applies type, area, and priority labels, detects duplicates, assesses quality, and optionally marks qualifying issues as agent-ready — and that it does not create sub-issues.

Steps to Reproduce

The change was introduced in PR #2223 (commit 3420081fc8ca7b9904dafb206445b01b6e4b38d6):

• .github/agents/issue-triage.agent.md — Removed the "Decompose Oversized Issues" section; updated the description to remove "decomposing".
• .github/workflows/issue-triage.md — Removed create-issue safe-output; expanded add-labels.allowed to include priority labels and a full area taxonomy.

The documentation page was not part of that PR.

Additional Context

• Stale documentation: docs/architecture/agentic-workflows.md — Mermaid diagram nodes F/G and flow edges ~L36–37, 69–72; Key Actions table ~L97; tip block ~L103–104.
• Source of truth: .github/agents/issue-triage.agent.md and .github/workflows/issue-triage.md (current state on main).

Generated by Documentation Update Check · 196 AIC · ⌖ 12.7 AIC · ⊞ 36.1K · ◷