# 1aifanatic/fde-agent-skills architecture

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

- Interactive diagram: https://gitdiagram.com/1aifanatic/fde-agent-skills
- Repository: https://github.com/1aifanatic/fde-agent-skills

## Overview

FDE Agent Skills is a skills-only operating system for forward deployed engineering, with an optional, documented Cloudflare application path that is not implemented here. The principal workflow starts by framing an engagement, then iterates stakeholder interviews and evidence capture, maps and redesigns the process, plans delivery, and governs later change. The run-engagement skill provides lifecycle routing; its scripts initialize and validate the portable Markdown workspace. Skill relationships and capabilities below follow the README; unsampled skill instructions and the optional application internals are not inferred.

Main entry points: [`skills/fde-interview-engagement/SKILL.md`](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-interview-engagement/SKILL.md) (Interview stakeholders), [`skills/fde-capture-knowledge/SKILL.md`](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-capture-knowledge/SKILL.md) (Capture knowledge), [`skills/fde-reengineer-process/SKILL.md`](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-reengineer-process/SKILL.md) (Reengineer process), [`skills/fde-plan-delivery/SKILL.md`](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-plan-delivery/SKILL.md) (Plan delivery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engagement["Engagement lifecycle"]
  node_run_skill["Run engagement<br/>[SKILL.md]"]
end

subgraph group_discovery["Discovery and process"]
  node_interview_skill["Interview stakeholders<br/>[SKILL.md]"]
  node_capture_skill["Capture knowledge<br/>[SKILL.md]"]
  node_reengineer_skill["Reengineer process<br/>[SKILL.md]"]
end

subgraph group_delivery["Delivery and change"]
  node_plan_skill["Plan delivery<br/>[SKILL.md]"]
  node_change_skill["Control change<br/>[SKILL.md]"]
end

subgraph group_workspace["Workspace support"]
  node_workspace_files["Engagement workspace<br/>[init_engagement.py]"]
  node_workspace_init["Workspace initializer<br/>[init_engagement.py]"]
  node_workspace_validator["Workspace validator"]
end

node_fde_user(("FDE user"))

node_fde_user -->|"invokes"| node_run_skill
node_run_skill -->|"initializes"| node_workspace_init
node_workspace_init -->|"writes"| node_workspace_files
node_fde_user -->|"invokes"| node_interview_skill
node_fde_user -->|"invokes"| node_capture_skill
node_fde_user -->|"invokes"| node_reengineer_skill
node_fde_user -->|"invokes"| node_plan_skill
node_fde_user -->|"invokes"| node_change_skill
node_interview_skill -->|"iterates with"| node_capture_skill
node_capture_skill -->|"resolves gaps with"| node_interview_skill
node_interview_skill -->|"informs"| node_reengineer_skill
node_capture_skill -->|"informs"| node_reengineer_skill
node_reengineer_skill -->|"feeds approved design"| node_plan_skill
node_plan_skill -->|"precedes later changes"| node_change_skill
node_fde_user -->|"validates workspace"| node_workspace_validator

click node_run_skill "https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-run-engagement/SKILL.md"
click node_interview_skill "https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-interview-engagement/SKILL.md"
click node_capture_skill "https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-capture-knowledge/SKILL.md"
click node_reengineer_skill "https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-reengineer-process/SKILL.md"
click node_plan_skill "https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-plan-delivery/SKILL.md"
click node_change_skill "https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-control-change/SKILL.md"
click node_workspace_files "https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-run-engagement/scripts/init_engagement.py"
click node_workspace_init "https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-run-engagement/scripts/init_engagement.py"
click node_workspace_validator "https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-run-engagement/scripts/validate_engagement.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_run_skill,node_fde_user toneBlue
class node_interview_skill,node_capture_skill,node_reengineer_skill toneAmber
class node_plan_skill,node_change_skill toneMint
class node_workspace_files,node_workspace_init,node_workspace_validator toneRose
```

## Components

### Engagement lifecycle

- [Run engagement](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-run-engagement/SKILL.md): `skills/fde-run-engagement/SKILL.md`

### Discovery and process

- [Interview stakeholders](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-interview-engagement/SKILL.md): `skills/fde-interview-engagement/SKILL.md`
- [Capture knowledge](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-capture-knowledge/SKILL.md): `skills/fde-capture-knowledge/SKILL.md`
- [Reengineer process](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-reengineer-process/SKILL.md): `skills/fde-reengineer-process/SKILL.md`

### Delivery and change

- [Plan delivery](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-plan-delivery/SKILL.md): `skills/fde-plan-delivery/SKILL.md`
- [Control change](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-control-change/SKILL.md): `skills/fde-control-change/SKILL.md`

### Workspace support

- [Engagement workspace](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-run-engagement/scripts/init_engagement.py): `skills/fde-run-engagement/scripts/init_engagement.py`
- [Workspace initializer](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-run-engagement/scripts/init_engagement.py): `skills/fde-run-engagement/scripts/init_engagement.py`
- [Workspace validator](https://github.com/1aifanatic/fde-agent-skills/blob/main/skills/fde-run-engagement/scripts/validate_engagement.py): `skills/fde-run-engagement/scripts/validate_engagement.py`

### Other components

- **FDE user**

## Connections

- FDE user → Run engagement: invokes (evidence: `README.md`)
- Run engagement → Workspace initializer: initializes (evidence: `README.md`)
- Workspace initializer → Engagement workspace: writes (evidence: `skills/fde-run-engagement/scripts/init_engagement.py`)
- FDE user → Interview stakeholders: invokes (evidence: `README.md`)
- FDE user → Capture knowledge: invokes (evidence: `README.md`)
- FDE user → Reengineer process: invokes (evidence: `README.md`)
- FDE user → Plan delivery: invokes (evidence: `README.md`)
- FDE user → Control change: invokes (evidence: `README.md`)
- Interview stakeholders → Capture knowledge: iterates with (evidence: `README.md`)
- Capture knowledge → Interview stakeholders: resolves gaps with (evidence: `README.md`)
- Interview stakeholders → Reengineer process: informs (evidence: `README.md`)
- Capture knowledge → Reengineer process: informs (evidence: `README.md`)
- Reengineer process → Plan delivery: feeds approved design (evidence: `README.md`)
- Plan delivery → Control change: precedes later changes (evidence: `README.md`)
- FDE user → Workspace validator: validates workspace (evidence: `skills/fde-run-engagement/scripts/validate_engagement.py`)
