# lambdapro/agentic-stlc-skill architecture

> Architecture diagram of the GitHub repository lambdapro/agentic-stlc-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lambdapro/agentic-stlc-skill
- Repository: https://github.com/lambdapro/agentic-stlc-skill

## Overview

Agentic STLC is a command-line skill that installs an autonomous validation pipeline into a target GitHub repository without modifying its application source. The main workflow analyzes the repository, bootstraps and injects the pipeline, then runs acceptance-criterion verification, scenario/test generation, regression execution, traceability, and a release verdict through GitHub Actions. Supporting branches analyze coverage and failures, apply self-healing patches, and summarize results. README documents the end-to-end stages; source excerpts and the index support selected internal calls, so other edges are omitted where caller evidence is unavailable.

Main entry points: [`ci/agent.py`](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/agent.py) (Pipeline Orchestrator), [`ci/repo_upgrade_orchestrator.py`](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/repo_upgrade_orchestrator.py) (Repo Upgrade Orchestrator), [`ci/failure_intelligence.py`](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/failure_intelligence.py) (Failure Intelligence), [`ci/normalize_artifacts.py`](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/normalize_artifacts.py) (Artifact Normalization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and Injection"]
  node_analyzer["Repository Analyzer<br/>[repo_analyzer.py]"]
  node_upgrader["Repo Upgrade Orchestrator"]
  node_injector["Workflow Injector<br/>[gha_injector.py]"]
  node_workflow["Injected Actions Workflow<br/>[gha_injector.py]"]
end

subgraph group_verification["Requirement Verification"]
  node_requirements["Requirement Verification"]
end

subgraph group_execution["Scenario and Execution"]
  node_scenarios["Scenario Management"]
  node_agent["Pipeline Orchestrator<br/>[agent.py]"]
  node_testgen["Kane Export Test Assembly"]
  node_selection["Test Selection<br/>[select_tests.py]"]
  node_regression["Regression Execution<br/>[agent.py]"]
  node_apiresults["Execution Result Details"]
  node_normalization["Artifact Normalization"]
  node_stageutils["Stage Utilities<br/>[stage_utils.py]"]
end

subgraph group_insights["Analysis and Recovery"]
  node_coverage["Coverage Analysis"]
  node_impact["Impact Analysis<br/>[impact_analysis.py]"]
  node_failure["Failure Intelligence"]
  node_rca["Root Cause Analysis<br/>[fetch_rca.py]"]
  node_healing["Self Healing<br/>[self_healing.py]"]
end

subgraph group_reporting["Traceability and Reporting"]
  node_traceability["Traceability Matrix"]
  node_verdict["Release Recommendation"]
  node_quality["Quality Gates<br/>[quality_gates.py]"]
  node_summary["GitHub Run Summary"]
end

node_user(("Skill User"))
node_targetrepo[("Target GitHub Repo")]
node_github["GitHub API and Actions"]
node_kane["KaneAI"]
node_grid["HyperExecute Grid"]

node_user -->|"runs command"| node_upgrader
node_upgrader -->|"clones and branches"| node_targetrepo
node_upgrader -->|"analyzes repository"| node_analyzer
node_analyzer -->|"reads repo metadata"| node_github
node_upgrader -->|"requests workflow injection"| node_injector
node_injector -->|"generates workflow"| node_workflow
node_upgrader -->|"pushes branch and triggers run"| node_github
node_github -->|"runs analyze job"| node_requirements
node_requirements -->|"verifies criteria"| node_kane
node_github -->|"runs orchestration job"| node_agent
node_agent -->|"manages scenarios"| node_scenarios
node_agent -->|"assembles tests"| node_testgen
node_agent -->|"selects tests"| node_selection
node_agent -->|"dispatches regression"| node_regression
node_regression -->|"runs parallel tests"| node_grid
node_agent -->|"fetches session details"| node_apiresults
node_agent -->|"normalizes results"| node_normalization
node_agent -->|"builds traceability"| node_traceability
node_agent -->|"recommends release"| node_verdict
node_github -->|"renders run summary"| node_summary
node_agent -->|"uses stage utilities"| node_stageutils
node_coverage -->|"reads normalized results"| node_normalization
node_failure -->|"reads traceability data"| node_traceability
node_failure -->|"reads execution results"| node_normalization
node_healing -.->|"uses failure analysis"| node_failure

click node_analyzer "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/repo_analyzer.py"
click node_upgrader "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/repo_upgrade_orchestrator.py"
click node_injector "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/gha_injector.py"
click node_workflow "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/gha_injector.py"
click node_requirements "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/analyze_requirements.py"
click node_scenarios "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/manage_scenarios.py"
click node_agent "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/agent.py"
click node_testgen "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/collect_kane_exports.py"
click node_selection "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/select_tests.py"
click node_regression "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/agent.py"
click node_apiresults "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/fetch_api_details.py"
click node_normalization "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/normalize_artifacts.py"
click node_coverage "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/coverage_analysis.py"
click node_impact "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/impact_analysis.py"
click node_failure "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/failure_intelligence.py"
click node_rca "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/fetch_rca.py"
click node_healing "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/self_healing.py"
click node_traceability "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/build_traceability.py"
click node_verdict "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/release_recommendation.py"
click node_quality "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/quality_gates.py"
click node_summary "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/write_github_summary.py"
click node_stageutils "https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/stage_utils.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_analyzer,node_upgrader,node_injector,node_workflow,node_user toneBlue
class node_requirements,node_targetrepo toneAmber
class node_scenarios,node_agent,node_testgen,node_selection,node_regression,node_apiresults,node_normalization,node_stageutils,node_github toneMint
class node_coverage,node_impact,node_failure,node_rca,node_healing toneRose
class node_traceability,node_verdict,node_quality,node_summary,node_kane,node_grid toneIndigo
```

## Components

### Setup and Injection

- [Repository Analyzer](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/repo_analyzer.py): `ci/repo_analyzer.py`
- [Repo Upgrade Orchestrator](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/repo_upgrade_orchestrator.py): `ci/repo_upgrade_orchestrator.py`
- [Workflow Injector](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/gha_injector.py): `ci/gha_injector.py`
- [Injected Actions Workflow](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/gha_injector.py): `ci/gha_injector.py`

### Requirement Verification

- [Requirement Verification](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/analyze_requirements.py): `ci/analyze_requirements.py`

### Scenario and Execution

- [Scenario Management](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/manage_scenarios.py): `ci/manage_scenarios.py`
- [Pipeline Orchestrator](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/agent.py): `ci/agent.py`
- [Kane Export Test Assembly](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/collect_kane_exports.py): `ci/collect_kane_exports.py`
- [Test Selection](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/select_tests.py): `ci/select_tests.py`
- [Regression Execution](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/agent.py): `ci/agent.py`
- [Execution Result Details](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/fetch_api_details.py): `ci/fetch_api_details.py`
- [Artifact Normalization](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/normalize_artifacts.py): `ci/normalize_artifacts.py`
- [Stage Utilities](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/stage_utils.py): `ci/stage_utils.py`

### Analysis and Recovery

- [Coverage Analysis](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/coverage_analysis.py): `ci/coverage_analysis.py`
- [Impact Analysis](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/impact_analysis.py): `ci/impact_analysis.py`
- [Failure Intelligence](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/failure_intelligence.py): `ci/failure_intelligence.py`
- [Root Cause Analysis](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/fetch_rca.py): `ci/fetch_rca.py`
- [Self Healing](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/self_healing.py): `ci/self_healing.py`

### Traceability and Reporting

- [Traceability Matrix](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/build_traceability.py): `ci/build_traceability.py`
- [Release Recommendation](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/release_recommendation.py): `ci/release_recommendation.py`
- [Quality Gates](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/quality_gates.py): `ci/quality_gates.py`
- [GitHub Run Summary](https://github.com/lambdapro/agentic-stlc-skill/blob/main/ci/write_github_summary.py): `ci/write_github_summary.py`

### Other components

- **Skill User**
- **Target GitHub Repo**
- **GitHub API and Actions**
- **KaneAI**
- **HyperExecute Grid**

## Connections

- Skill User → Repo Upgrade Orchestrator: runs command (evidence: `README.md`)
- Repo Upgrade Orchestrator → Target GitHub Repo: clones and branches (evidence: `README.md`)
- Repo Upgrade Orchestrator → Repository Analyzer: analyzes repository (evidence: `ci/repo_upgrade_orchestrator.py`)
- Repository Analyzer → GitHub API and Actions: reads repo metadata (evidence: `ci/repo_analyzer.py`)
- Repo Upgrade Orchestrator → Workflow Injector: requests workflow injection (evidence: `ci/repo_upgrade_orchestrator.py`)
- Workflow Injector → Injected Actions Workflow: generates workflow (evidence: `ci/gha_injector.py`)
- Repo Upgrade Orchestrator → GitHub API and Actions: pushes branch and triggers run (evidence: `README.md`)
- GitHub API and Actions → Requirement Verification: runs analyze job
- Requirement Verification → KaneAI: verifies criteria (evidence: `README.md`)
- GitHub API and Actions → Pipeline Orchestrator: runs orchestration job
- Pipeline Orchestrator → Scenario Management: manages scenarios (evidence: `README.md`)
- Pipeline Orchestrator → Kane Export Test Assembly: assembles tests (evidence: `README.md`)
- Pipeline Orchestrator → Test Selection: selects tests (evidence: `README.md`)
- Pipeline Orchestrator → Regression Execution: dispatches regression (evidence: `README.md`)
- Regression Execution → HyperExecute Grid: runs parallel tests (evidence: `README.md`)
- Pipeline Orchestrator → Execution Result Details: fetches session details (evidence: `README.md`)
- Pipeline Orchestrator → Artifact Normalization: normalizes results (evidence: `ci/agent.py`)
- Pipeline Orchestrator → Traceability Matrix: builds traceability (evidence: `README.md`)
- Pipeline Orchestrator → Release Recommendation: recommends release (evidence: `README.md`)
- GitHub API and Actions → GitHub Run Summary: renders run summary (evidence: `README.md`)
- Pipeline Orchestrator → Stage Utilities: uses stage utilities (evidence: `ci/agent.py`)
- Coverage Analysis → Artifact Normalization: reads normalized results (evidence: `ci/coverage_analysis.py`)
- Failure Intelligence → Traceability Matrix: reads traceability data (evidence: `ci/failure_intelligence.py`)
- Failure Intelligence → Artifact Normalization: reads execution results (evidence: `ci/failure_intelligence.py`)
- Self Healing → Failure Intelligence: uses failure analysis