Skip to content

Commit 9b767eb

Browse files
docs: remove duplicate deployment section and redundant lists in agentic-observability-kit (#28391)
1 parent f187aa4 commit 9b767eb

1 file changed

Lines changed: 1 addition & 46 deletions

File tree

docs/src/content/docs/patterns/agentic-observability-kit.md

Lines changed: 1 addition & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -30,26 +30,6 @@ Enterprise-wide use is possible as an architecture, but it is not a single built
3030
> [!IMPORTANT]
3131
> The built-in Agentic Observability Kit should be treated as the repository-level building block. Organization-wide and enterprise-wide deployments require additional cross-repository authentication, central orchestration, and portfolio aggregation logic.
3232
33-
## Recommended deployment model
34-
35-
The recommended approach depends on scope.
36-
37-
### Single repository
38-
39-
Use the built-in workflow directly in that repository. This is the intended default and requires the least operational overhead.
40-
41-
### One organization
42-
43-
Prefer a central repository or control-plane repository that aggregates results from many repositories. This is usually better than installing an independent copy of the workflow in every repository, because it keeps the reporting logic, authentication, routing, and portfolio rollup in one place.
44-
45-
Installing the workflow in every repository can still make sense when each repository has its own maintainers and needs a self-contained local report. That model is operationally simpler at first, but it produces fragmented reporting and makes organization-level prioritization harder.
46-
47-
### Enterprise-wide across multiple organizations
48-
49-
Prefer the same central aggregation model, but treat it as fleet operations rather than a simple workflow rollout. In practice, that means one or more control-plane repositories collecting normalized data from many repositories or organizations and publishing a portfolio-level report.
50-
51-
This is the recommended model because enterprise-wide observability usually needs shared policy, shared authentication, shared repository allowlists, and a consistent rollup format. Duplicating the workflow everywhere and trying to reconcile the reports afterward is usually the wrong tradeoff.
52-
5333
## Deployment by scope
5434

5535
The practical setup differs by scope.
@@ -204,13 +184,6 @@ This plot is a workflow-by-workflow similarity heatmap. It is intended to serve
204184

205185
This is the fastest way to answer: which workflows may be solving the same problem closely enough to justify consolidation review?
206186

207-
The intended visuals are:
208-
209-
- an episode risk-cost frontier showing which execution chains are both expensive and risky
210-
- a workflow stability matrix showing which workflows repeatedly accumulate control, risk, or fallback problems
211-
- a repository portfolio map that separates `keep`, `optimize`, `simplify`, and `review` candidates
212-
- a workflow overlap matrix that acts like a portfolio overlap view, similar in purpose to a Venn diagram but usually more precise for many workflows
213-
214187
This format is better than a purely textual report when maintainers need to answer questions such as:
215188

216189
- which workflows sit on the cost-risk frontier
@@ -335,25 +308,7 @@ The Agentic Observability Kit sits above those tools. It is the scheduled review
335308

336309
## Portfolio review capabilities
337310

338-
The kit now includes the most useful repository-level capabilities that were previously split into a separate portfolio-style review.
339-
340-
In this repository, the standalone `portfolio-analyst` workflow has been superseded by the kit. Maintainers who want one weekly report should use the Agentic Observability Kit instead of running both workflows.
341-
342-
At repository scope, that means the report can now surface questions such as:
343-
344-
- which workflows appear repeatedly overkill for their task domain
345-
- which workflows look expensive relative to their recent value or stability
346-
- which workflows may overlap in purpose, trigger pattern, or schedule
347-
- which workflows look stale or weakly justified by recent activity
348-
349-
The highest-value cleanup candidates are usually workflows that are dominated on more than one axis at the same time, such as expensive and unstable, cheap but consistently low-value, or overlapping and weaker than a nearby alternative.
350-
351-
This remains an evidence-based repository-maintainer view, not a full fleet-governance system. The primary job of the kit is still operational observability.
352-
353-
At organization or enterprise scope, the same pattern can be extended into a deeper portfolio rollup. That broader layer is where consolidation, retirement, cross-repository overlap, and fleet-wide prioritization fit best.
354-
355-
> [!TIP]
356-
> The repository-level kit is now sufficient for maintainers who want one weekly report covering both operational regressions and evidence-based repository portfolio cleanup opportunities. Central rollups remain the better place for full portfolio governance.
311+
The standalone `portfolio-analyst` workflow has been superseded by the Agentic Observability Kit. Maintainers who want one weekly report should use the kit instead of running both workflows. The highest-value cleanup candidates are workflows dominated on more than one axis — expensive and unstable, cheap but consistently low-value, or overlapping and weaker than a nearby alternative.
357312

358313
## Source workflow
359314

0 commit comments

Comments
 (0)