# mjtpena/fabric-apps-forward-deployed-accelerator architecture

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

- Interactive diagram: https://gitdiagram.com/mjtpena/fabric-apps-forward-deployed-accelerator
- Repository: https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator

## Overview

This repository is a document- and script-based accelerator, not the Fabric application runtime. It guides teams from customer discovery and fit assessment through specification, implementation, review, and controlled deployment. Its main product assets are lifecycle guidance, Copilot agents and prompts, reusable templates, evaluation checklists, and a scaffold overlay. The README describes how these assets are used; source excerpts are limited to the README and package metadata, so internal behavior of scripts and workflows is not inferred.

Main entry points: [`.github/agents/fabric-fde-lead.agent.md`](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/agents/fabric-fde-lead.agent.md) (FDE lead agent), [`scripts/scaffold.ps1`](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/scripts/scaffold.ps1) (Project scaffold), [`.github/prompts`](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/.github/prompts) (Workflow prompts), [`.github/agents/fabric-app-builder.agent.md`](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/agents/fabric-app-builder.agent.md) (App builder agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Engagement lifecycle"]
  node_lifecycleguide["Lifecycle guide<br/>[lifecycle.md]"]
  node_generalisation["Generalisation guidance"]
end

subgraph group_engineering["Engineering guidance"]
  node_fde["FDE lead agent"]
  node_builder["App builder agent"]
  node_reviewer["App reviewer agent"]
  node_prompts["Workflow prompts<br/>[prompts]"]
  node_evaluations["Readiness evaluations"]
end

subgraph group_assets["Project assets"]
  node_fitassessments["Fit assessments"]
  node_engagementtemplates["Engagement templates"]
  node_specs["Project specifications"]
  node_scaffold["Project scaffold<br/>[scaffold.ps1]"]
end

subgraph group_delivery["Delivery and operations"]
  node_validation["Project validation"]
  node_devdeploy["Development deployment"]
  node_proddeploy["Production deployment"]
  node_opsdocs["Operations runbooks"]
end

node_team(("Delivery team"))
node_rayfin["Rayfin scaffold"]

node_team -->|"follows lifecycle"| node_lifecycleguide
node_team -->|"starts discovery"| node_fde
node_fde -->|"completes fit gates"| node_fitassessments
node_fde -->|"defines MVV"| node_engagementtemplates
node_fde -->|"readies specification"| node_specs
node_team -->|"generates project"| node_scaffold
node_scaffold -->|"invokes scaffold"| node_rayfin
node_scaffold -->|"overlays assets"| node_specs
node_builder -->|"implements task"| node_team
node_reviewer -->|"reviews quality"| node_team
node_team -->|"checks readiness"| node_evaluations
node_team -->|"validates project"| node_validation
node_team -->|"merges to deploy"| node_devdeploy
node_team -->|"releases to deploy"| node_proddeploy
node_team -->|"operates with"| node_opsdocs
node_team -->|"generalises learning"| node_generalisation
node_fde -.->|"uses guidance"| node_prompts
node_builder -.->|"uses guidance"| node_prompts
node_reviewer -.->|"uses guidance"| node_prompts

click node_lifecycleguide "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/accelerator/lifecycle.md"
click node_fde "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/agents/fabric-fde-lead.agent.md"
click node_builder "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/agents/fabric-app-builder.agent.md"
click node_reviewer "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/agents/fabric-app-reviewer.agent.md"
click node_prompts "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/.github/prompts"
click node_fitassessments "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/templates/architecture"
click node_engagementtemplates "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/templates/engagement"
click node_specs "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/scaffolding/overlay/specs"
click node_scaffold "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/scripts/scaffold.ps1"
click node_evaluations "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/evaluations"
click node_validation "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/scripts/validate-project.ps1"
click node_devdeploy "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/workflows/deploy-development.yml"
click node_proddeploy "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/workflows/deploy-production.yml"
click node_opsdocs "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/templates/operations"
click node_generalisation "https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/prompts/fabric-generalise.prompt.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_lifecycleguide,node_generalisation toneBlue
class node_fde,node_builder,node_reviewer,node_prompts,node_evaluations toneAmber
class node_fitassessments,node_engagementtemplates,node_specs,node_scaffold toneMint
class node_validation,node_devdeploy,node_proddeploy,node_opsdocs toneRose
class node_team,node_rayfin toneIndigo
```

## Components

### Engagement lifecycle

- [Lifecycle guide](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/accelerator/lifecycle.md): `accelerator/lifecycle.md`
- [Generalisation guidance](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/prompts/fabric-generalise.prompt.md): `.github/prompts/fabric-generalise.prompt.md`

### Engineering guidance

- [FDE lead agent](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/agents/fabric-fde-lead.agent.md): `.github/agents/fabric-fde-lead.agent.md`
- [App builder agent](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/agents/fabric-app-builder.agent.md): `.github/agents/fabric-app-builder.agent.md`
- [App reviewer agent](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/agents/fabric-app-reviewer.agent.md): `.github/agents/fabric-app-reviewer.agent.md`
- [Workflow prompts](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/.github/prompts): `.github/prompts`
- [Readiness evaluations](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/evaluations): `evaluations`

### Project assets

- [Fit assessments](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/templates/architecture): `templates/architecture`
- [Engagement templates](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/templates/engagement): `templates/engagement`
- [Project specifications](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/scaffolding/overlay/specs): `scaffolding/overlay/specs`
- [Project scaffold](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/scripts/scaffold.ps1): `scripts/scaffold.ps1`

### Delivery and operations

- [Project validation](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/scripts/validate-project.ps1): `scripts/validate-project.ps1`
- [Development deployment](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/workflows/deploy-development.yml): `.github/workflows/deploy-development.yml`
- [Production deployment](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/blob/main/.github/workflows/deploy-production.yml): `.github/workflows/deploy-production.yml`
- [Operations runbooks](https://github.com/mjtpena/fabric-apps-forward-deployed-accelerator/tree/main/templates/operations): `templates/operations`

### Other components

- **Delivery team**
- **Rayfin scaffold**

## Connections

- Delivery team → Lifecycle guide: follows lifecycle (evidence: `README.md`)
- Delivery team → FDE lead agent: starts discovery (evidence: `README.md`)
- FDE lead agent → Fit assessments: completes fit gates (evidence: `README.md`)
- FDE lead agent → Engagement templates: defines MVV (evidence: `README.md`)
- FDE lead agent → Project specifications: readies specification (evidence: `README.md`)
- Delivery team → Project scaffold: generates project (evidence: `README.md`)
- Project scaffold → Rayfin scaffold: invokes scaffold (evidence: `README.md`)
- Project scaffold → Project specifications: overlays assets (evidence: `README.md`)
- App builder agent → Delivery team: implements task (evidence: `README.md`)
- App reviewer agent → Delivery team: reviews quality (evidence: `README.md`)
- Delivery team → Readiness evaluations: checks readiness (evidence: `README.md`)
- Delivery team → Project validation: validates project (evidence: `README.md`)
- Delivery team → Development deployment: merges to deploy (evidence: `README.md`)
- Delivery team → Production deployment: releases to deploy (evidence: `README.md`)
- Delivery team → Operations runbooks: operates with (evidence: `README.md`)
- Delivery team → Generalisation guidance: generalises learning (evidence: `README.md`)
- FDE lead agent → Workflow prompts: uses guidance
- App builder agent → Workflow prompts: uses guidance
- App reviewer agent → Workflow prompts: uses guidance
