# githubnext/agentics architecture

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

- Interactive diagram: https://gitdiagram.com/githubnext/agentics
- Repository: https://github.com/githubnext/agentics

## Overview

The Agentics is a catalog of reusable GitHub Agentic Workflows, not a conventional application with a shared runtime pipeline. Its principal workflow is a GitHub event or maintainer command dispatching an agent workflow that investigates repository context and produces a report, comment, issue, or code change. The graph groups documented capabilities and points to workflow definitions; no source excerpts were provided, so internal calls and shared execution layers cannot be established. Edges reflect README-documented triggers and outcomes only.

Main entry points: [`workflows/issue-triage.md`](https://github.com/githubnext/agentics/blob/main/workflows/issue-triage.md) (Issue triage), [`workflows/repo-assist.md`](https://github.com/githubnext/agentics/blob/main/workflows/repo-assist.md) (Repo Assist), [`workflows/ci-doctor.md`](https://github.com/githubnext/agentics/blob/main/workflows/ci-doctor.md) (CI Doctor), [`workflows/cost-tracker.md`](https://github.com/githubnext/agentics/blob/main/workflows/cost-tracker.md) (Cost Tracker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_maintenance["Maintenance"]
  node_issue_triage["Issue triage<br/>[issue-triage.md]"]
  node_repo_assist["Repo Assist<br/>[repo-assist.md]"]
  node_moderation["AI moderation<br/>[ai-moderator.md]"]
end

subgraph group_analysis["Faults and review"]
  node_ci_doctor["CI Doctor<br/>[ci-doctor.md]"]
  node_ci_coach["CI Coach<br/>[ci-coach.md]"]
  node_cost_tracker["Cost Tracker<br/>[cost-tracker.md]"]
  node_reviewers["Code reviewers<br/>[grumpy-reviewer.md]"]
  node_contribution_check["Contribution checks"]
end

subgraph group_research["Research and planning"]
  node_weekly_research["Weekly research<br/>[weekly-research.md]"]
  node_repo_status["Repository status<br/>[repo-status.md]"]
  node_team_status["Team status<br/>[team-status.md]"]
  node_planning["Planning<br/>[plan.md]"]
  node_task_mining["Discussion task mining"]
end

subgraph group_docs["Documentation"]
  node_doc_update["Documentation updates<br/>[update-docs.md]"]
  node_wiki_writer["Wiki writer"]
  node_link_checker["Link checker<br/>[link-checker.md]"]
end

subgraph group_improvement["Code improvement"]
  node_accessibility["Accessibility review"]
  node_qa["Adhoc QA<br/>[adhoc-qa.md]"]
  node_code_simplifier["Code simplifier<br/>[code-simplifier.md]"]
  node_test_improver["Test improver<br/>[test-improver.md]"]
  node_perf_improver["Performance improver<br/>[perf-improver.md]"]
end

node_maintainer(("Maintainer"))
node_repo_events(("Repository activity"))
node_workflow_results["Reports and changes"]

node_repo_events -->|"triggers triage"| node_issue_triage
node_repo_events -->|"prompts assistance"| node_repo_assist
node_repo_events -->|"prompts moderation"| node_moderation
node_repo_events -->|"prompts investigation"| node_ci_doctor
node_repo_events -->|"prompts reporting"| node_cost_tracker
node_maintainer -->|"requests review"| node_reviewers
node_repo_events -->|"triggers review"| node_contribution_check
node_repo_events -->|"triggers research"| node_weekly_research
node_repo_events -->|"triggers assessment"| node_repo_status
node_repo_events -->|"triggers summary"| node_team_status
node_repo_events -->|"triggers planning"| node_planning
node_repo_events -->|"triggers extraction"| node_task_mining
node_repo_events -->|"triggers updates"| node_doc_update
node_repo_events -->|"triggers generation"| node_wiki_writer
node_repo_events -->|"triggers checking"| node_link_checker
node_maintainer -->|"requests review"| node_accessibility
node_maintainer -->|"requests testing"| node_qa
node_repo_events -->|"triggers simplification"| node_code_simplifier
node_repo_events -->|"triggers improvement"| node_test_improver
node_repo_events -->|"triggers optimization"| node_perf_improver
node_issue_triage -->|"produces triage"| node_workflow_results
node_repo_assist -->|"produces assistance"| node_workflow_results
node_ci_doctor -->|"reports failures"| node_workflow_results
node_cost_tracker -->|"posts summaries"| node_workflow_results
node_weekly_research -->|"reports research"| node_workflow_results
node_repo_status -->|"creates reports"| node_workflow_results
node_task_mining -->|"creates issues"| node_workflow_results
node_doc_update -->|"updates docs"| node_workflow_results
node_code_simplifier -->|"proposes changes"| node_workflow_results
node_test_improver -->|"proposes tests"| node_workflow_results
node_perf_improver -->|"proposes optimizations"| node_workflow_results

click node_issue_triage "https://github.com/githubnext/agentics/blob/main/workflows/issue-triage.md"
click node_repo_assist "https://github.com/githubnext/agentics/blob/main/workflows/repo-assist.md"
click node_moderation "https://github.com/githubnext/agentics/blob/main/workflows/ai-moderator.md"
click node_ci_doctor "https://github.com/githubnext/agentics/blob/main/workflows/ci-doctor.md"
click node_ci_coach "https://github.com/githubnext/agentics/blob/main/workflows/ci-coach.md"
click node_cost_tracker "https://github.com/githubnext/agentics/blob/main/workflows/cost-tracker.md"
click node_reviewers "https://github.com/githubnext/agentics/blob/main/workflows/grumpy-reviewer.md"
click node_contribution_check "https://github.com/githubnext/agentics/blob/main/workflows/contribution-check.md"
click node_weekly_research "https://github.com/githubnext/agentics/blob/main/workflows/weekly-research.md"
click node_repo_status "https://github.com/githubnext/agentics/blob/main/workflows/repo-status.md"
click node_team_status "https://github.com/githubnext/agentics/blob/main/workflows/team-status.md"
click node_planning "https://github.com/githubnext/agentics/blob/main/workflows/plan.md"
click node_task_mining "https://github.com/githubnext/agentics/blob/main/workflows/discussion-task-miner.md"
click node_doc_update "https://github.com/githubnext/agentics/blob/main/workflows/update-docs.md"
click node_wiki_writer "https://github.com/githubnext/agentics/blob/main/workflows/agentic-wiki-writer.md"
click node_link_checker "https://github.com/githubnext/agentics/blob/main/workflows/link-checker.md"
click node_accessibility "https://github.com/githubnext/agentics/blob/main/workflows/accessibility-review.md"
click node_qa "https://github.com/githubnext/agentics/blob/main/workflows/adhoc-qa.md"
click node_code_simplifier "https://github.com/githubnext/agentics/blob/main/workflows/code-simplifier.md"
click node_test_improver "https://github.com/githubnext/agentics/blob/main/workflows/test-improver.md"
click node_perf_improver "https://github.com/githubnext/agentics/blob/main/workflows/perf-improver.md"

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_issue_triage,node_repo_assist,node_moderation toneBlue
class node_ci_doctor,node_ci_coach,node_cost_tracker,node_reviewers,node_contribution_check toneAmber
class node_weekly_research,node_repo_status,node_team_status,node_planning,node_task_mining toneMint
class node_doc_update,node_wiki_writer,node_link_checker toneRose
class node_accessibility,node_qa,node_code_simplifier,node_test_improver,node_perf_improver,node_maintainer,node_repo_events,node_workflow_results toneIndigo
```

## Components

### Maintenance

- [Issue triage](https://github.com/githubnext/agentics/blob/main/workflows/issue-triage.md): `workflows/issue-triage.md`
- [Repo Assist](https://github.com/githubnext/agentics/blob/main/workflows/repo-assist.md): `workflows/repo-assist.md`
- [AI moderation](https://github.com/githubnext/agentics/blob/main/workflows/ai-moderator.md): `workflows/ai-moderator.md`

### Faults and review

- [CI Doctor](https://github.com/githubnext/agentics/blob/main/workflows/ci-doctor.md): `workflows/ci-doctor.md`
- [CI Coach](https://github.com/githubnext/agentics/blob/main/workflows/ci-coach.md): `workflows/ci-coach.md`
- [Cost Tracker](https://github.com/githubnext/agentics/blob/main/workflows/cost-tracker.md): `workflows/cost-tracker.md`
- [Code reviewers](https://github.com/githubnext/agentics/blob/main/workflows/grumpy-reviewer.md): `workflows/grumpy-reviewer.md`
- [Contribution checks](https://github.com/githubnext/agentics/blob/main/workflows/contribution-check.md): `workflows/contribution-check.md`

### Research and planning

- [Weekly research](https://github.com/githubnext/agentics/blob/main/workflows/weekly-research.md): `workflows/weekly-research.md`
- [Repository status](https://github.com/githubnext/agentics/blob/main/workflows/repo-status.md): `workflows/repo-status.md`
- [Team status](https://github.com/githubnext/agentics/blob/main/workflows/team-status.md): `workflows/team-status.md`
- [Planning](https://github.com/githubnext/agentics/blob/main/workflows/plan.md): `workflows/plan.md`
- [Discussion task mining](https://github.com/githubnext/agentics/blob/main/workflows/discussion-task-miner.md): `workflows/discussion-task-miner.md`

### Documentation

- [Documentation updates](https://github.com/githubnext/agentics/blob/main/workflows/update-docs.md): `workflows/update-docs.md`
- [Wiki writer](https://github.com/githubnext/agentics/blob/main/workflows/agentic-wiki-writer.md): `workflows/agentic-wiki-writer.md`
- [Link checker](https://github.com/githubnext/agentics/blob/main/workflows/link-checker.md): `workflows/link-checker.md`

### Code improvement

- [Accessibility review](https://github.com/githubnext/agentics/blob/main/workflows/accessibility-review.md): `workflows/accessibility-review.md`
- [Adhoc QA](https://github.com/githubnext/agentics/blob/main/workflows/adhoc-qa.md): `workflows/adhoc-qa.md`
- [Code simplifier](https://github.com/githubnext/agentics/blob/main/workflows/code-simplifier.md): `workflows/code-simplifier.md`
- [Test improver](https://github.com/githubnext/agentics/blob/main/workflows/test-improver.md): `workflows/test-improver.md`
- [Performance improver](https://github.com/githubnext/agentics/blob/main/workflows/perf-improver.md): `workflows/perf-improver.md`

### Other components

- **Maintainer**
- **Repository activity**
- **Reports and changes**

## Connections

- Repository activity → Issue triage: triggers triage (evidence: `README.md`)
- Repository activity → Repo Assist: prompts assistance (evidence: `README.md`)
- Repository activity → AI moderation: prompts moderation (evidence: `README.md`)
- Repository activity → CI Doctor: prompts investigation (evidence: `README.md`)
- Repository activity → Cost Tracker: prompts reporting (evidence: `README.md`)
- Maintainer → Code reviewers: requests review (evidence: `README.md`)
- Repository activity → Contribution checks: triggers review (evidence: `README.md`)
- Repository activity → Weekly research: triggers research (evidence: `README.md`)
- Repository activity → Repository status: triggers assessment (evidence: `README.md`)
- Repository activity → Team status: triggers summary (evidence: `README.md`)
- Repository activity → Planning: triggers planning (evidence: `README.md`)
- Repository activity → Discussion task mining: triggers extraction (evidence: `README.md`)
- Repository activity → Documentation updates: triggers updates (evidence: `README.md`)
- Repository activity → Wiki writer: triggers generation (evidence: `README.md`)
- Repository activity → Link checker: triggers checking (evidence: `README.md`)
- Maintainer → Accessibility review: requests review (evidence: `README.md`)
- Maintainer → Adhoc QA: requests testing (evidence: `README.md`)
- Repository activity → Code simplifier: triggers simplification (evidence: `README.md`)
- Repository activity → Test improver: triggers improvement (evidence: `README.md`)
- Repository activity → Performance improver: triggers optimization (evidence: `README.md`)
- Issue triage → Reports and changes: produces triage (evidence: `README.md`)
- Repo Assist → Reports and changes: produces assistance (evidence: `README.md`)
- CI Doctor → Reports and changes: reports failures (evidence: `README.md`)
- Cost Tracker → Reports and changes: posts summaries (evidence: `README.md`)
- Weekly research → Reports and changes: reports research (evidence: `README.md`)
- Repository status → Reports and changes: creates reports (evidence: `README.md`)
- Discussion task mining → Reports and changes: creates issues (evidence: `README.md`)
- Documentation updates → Reports and changes: updates docs (evidence: `README.md`)
- Code simplifier → Reports and changes: proposes changes (evidence: `README.md`)
- Test improver → Reports and changes: proposes tests (evidence: `README.md`)
- Performance improver → Reports and changes: proposes optimizations (evidence: `README.md`)
