# ldaume/agentic-engineering-harness architecture

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

- Interactive diagram: https://gitdiagram.com/ldaume/agentic-engineering-harness
- Repository: https://github.com/ldaume/agentic-engineering-harness

## Overview

This repository is a portable catalog of installable Agent Skills and adaptable harness blueprints, not a control plane. The primary workflow is to choose Skills, install them for an agent host, and use them in a target repository; users can instead adapt the blueprints alone or combine both. The graph preserves the README’s main capability areas and the documented Jev routing and iteration-gate integration. Most skill and blueprint internals were not sampled, so links between them are limited to documented usage.

Main entry points: [`skills/engineering/system-one-routing/scripts/jev_client.py`](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/system-one-routing/scripts/jev_client.py) (Jev client), [`skills/engineering/system-one-routing/scripts/route-subagent.py`](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/system-one-routing/scripts/route-subagent.py) (Subagent router), [`skills/engineering/scaffold-harness/SKILL.md`](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/scaffold-harness/SKILL.md) (Scaffold harness), [`skills/engineering/system-one-routing/scripts/iteration-gate.py`](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/system-one-routing/scripts/iteration-gate.py) (Iteration gate)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Skill catalog"]
  node_skill_catalog["Portable Skills"]
  node_engineering_skills["Engineering Skills"]
  node_backend_skills["Backend Skills"]
  node_frontend_skills["Frontend Skills"]
  node_infra_skills["Infrastructure Skills"]
  node_testing_skills["Testing Skills"]
  node_product_skills["Product Skills"]
end

subgraph group_harness["Harness blueprints"]
  node_harness_blueprints["Harness blueprints<br/>[HARNESS.md]"]
  node_harness_operations["Harness operations"]
  node_multi_repo["Multi-repo model"]
  node_scaffold["Scaffold harness<br/>[SKILL.md]"]
end

subgraph group_practice["Product practices"]
  node_product_craft["Product craft<br/>[SKILL.md]"]
  node_product_engineering["Product engineering<br/>[SKILL.md]"]
end

subgraph group_routing["Typed routing"]
  node_jev_router["Subagent router<br/>[route-subagent.py]"]
  node_iteration_gate["Iteration gate<br/>[iteration-gate.py]"]
  node_jev_client["Jev client<br/>[jev_client.py]"]
end

node_engineer(("Engineer"))
node_skills_cli["Skills CLI"]
node_agent_host["Agent host"]
node_target_repo[("Target repository")]
node_jev_service["Jev service"]

node_engineer -->|"invokes install"| node_skills_cli
node_skills_cli -->|"installs Skills"| node_skill_catalog
node_engineer -->|"reads and adapts"| node_harness_blueprints
node_engineer -->|"chooses scope"| node_target_repo
node_agent_host -->|"loads installed Skills"| node_skill_catalog
node_agent_host -->|"applies guidance"| node_target_repo
node_engineering_skills -->|"includes"| node_scaffold
node_harness_operations -->|"describes topology"| node_multi_repo
node_scaffold -->|"guides assessment"| node_target_repo
node_product_craft -->|"guides issue shaping"| node_target_repo
node_product_engineering -->|"guides delivery loop"| node_target_repo
node_jev_router -->|"requests evaluation"| node_jev_client
node_iteration_gate -->|"requests evaluation"| node_jev_client
node_jev_client -.->|"sends typed questions"| node_jev_service
node_jev_client -->|"returns normalized answers"| node_jev_router
node_jev_client -->|"returns normalized answers"| node_iteration_gate
node_agent_host -.->|"routes subagent tasks"| node_jev_router

click node_skill_catalog "https://github.com/ldaume/agentic-engineering-harness/tree/main/skills"
click node_engineering_skills "https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/engineering"
click node_backend_skills "https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/backend"
click node_frontend_skills "https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/frontend"
click node_infra_skills "https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/infrastructure"
click node_testing_skills "https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/testing"
click node_product_skills "https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/product"
click node_harness_blueprints "https://github.com/ldaume/agentic-engineering-harness/blob/main/HARNESS.md"
click node_harness_operations "https://github.com/ldaume/agentic-engineering-harness/blob/main/HARNESS-OPERATIONS.md"
click node_multi_repo "https://github.com/ldaume/agentic-engineering-harness/blob/main/MULTI-REPO-HARNESS.md"
click node_scaffold "https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/scaffold-harness/SKILL.md"
click node_product_craft "https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/product/product-craft/SKILL.md"
click node_product_engineering "https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/product/run-product-engineering/SKILL.md"
click node_jev_router "https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/system-one-routing/scripts/route-subagent.py"
click node_iteration_gate "https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/system-one-routing/scripts/iteration-gate.py"
click node_jev_client "https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/system-one-routing/scripts/jev_client.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_skill_catalog,node_engineering_skills,node_backend_skills,node_frontend_skills,node_infra_skills,node_testing_skills,node_product_skills toneBlue
class node_harness_blueprints,node_harness_operations,node_multi_repo,node_scaffold,node_target_repo toneAmber
class node_product_craft,node_product_engineering toneMint
class node_jev_router,node_iteration_gate,node_jev_client toneRose
class node_engineer,node_skills_cli,node_agent_host,node_jev_service toneIndigo
```

## Components

### Skill catalog

- [Portable Skills](https://github.com/ldaume/agentic-engineering-harness/tree/main/skills): `skills`
- [Engineering Skills](https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/engineering): `skills/engineering`
- [Backend Skills](https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/backend): `skills/backend`
- [Frontend Skills](https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/frontend): `skills/frontend`
- [Infrastructure Skills](https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/infrastructure): `skills/infrastructure`
- [Testing Skills](https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/testing): `skills/testing`
- [Product Skills](https://github.com/ldaume/agentic-engineering-harness/tree/main/skills/product): `skills/product`

### Harness blueprints

- [Harness blueprints](https://github.com/ldaume/agentic-engineering-harness/blob/main/HARNESS.md): `HARNESS.md`
- [Harness operations](https://github.com/ldaume/agentic-engineering-harness/blob/main/HARNESS-OPERATIONS.md): `HARNESS-OPERATIONS.md`
- [Multi-repo model](https://github.com/ldaume/agentic-engineering-harness/blob/main/MULTI-REPO-HARNESS.md): `MULTI-REPO-HARNESS.md`
- [Scaffold harness](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/scaffold-harness/SKILL.md): `skills/engineering/scaffold-harness/SKILL.md`

### Product practices

- [Product craft](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/product/product-craft/SKILL.md): `skills/product/product-craft/SKILL.md`
- [Product engineering](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/product/run-product-engineering/SKILL.md): `skills/product/run-product-engineering/SKILL.md`

### Typed routing

- [Subagent router](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/system-one-routing/scripts/route-subagent.py): `skills/engineering/system-one-routing/scripts/route-subagent.py`
- [Iteration gate](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/system-one-routing/scripts/iteration-gate.py): `skills/engineering/system-one-routing/scripts/iteration-gate.py`
- [Jev client](https://github.com/ldaume/agentic-engineering-harness/blob/main/skills/engineering/system-one-routing/scripts/jev_client.py): `skills/engineering/system-one-routing/scripts/jev_client.py`

### Other components

- **Engineer**
- **Skills CLI**
- **Agent host**
- **Target repository**
- **Jev service**

## Connections

- Engineer → Skills CLI: invokes install
- Skills CLI → Portable Skills: installs Skills
- Engineer → Harness blueprints: reads and adapts
- Engineer → Target repository: chooses scope
- Agent host → Portable Skills: loads installed Skills
- Agent host → Target repository: applies guidance
- Engineering Skills → Scaffold harness: includes
- Harness operations → Multi-repo model: describes topology
- Scaffold harness → Target repository: guides assessment
- Product craft → Target repository: guides issue shaping
- Product engineering → Target repository: guides delivery loop
- Subagent router → Jev client: requests evaluation
- Iteration gate → Jev client: requests evaluation
- Jev client → Jev service: sends typed questions
- Jev client → Subagent router: returns normalized answers
- Jev client → Iteration gate: returns normalized answers
- Agent host → Subagent router: routes subagent tasks